Map elements allow you to visualize location-based data from your DataTables on an interactive map interface. They combine geographical display with customizable record details to create powerful location-aware experiences.
Important: Map elements are only available on Trials, and Pro plans and above.
- What You'll Learn
- How to create and configure Map elements
- Ways to customize location displays and markers
- Methods for implementing search and filtering
- Techniques for optimizing map performance
- Best practices for handling location data
- Solutions for common map configuration challenges
Prerequisites
- At least one table with an address field that has geo-coding enabled
- Google Maps API key (if using Google Maps provider)
- Map ID (required for Google Maps as of January 29, 2024)
Basic Configuration
Location Settings
- Address Field: Select the address field for plotting points
- Title Field: Choose identifying field for location markers
- Starting Point Options:
- Blank (user must search)
- Specific address
- User's current location
- Units: Miles or kilometers
Display Settings
- Map Size: Custom dimensions in pixels
- List Width: Details panel sizing
- Starting Range: Initial search radius
- Pin Colors: Conditional marker styling
Features and Functionality
Search Capabilities
Supported Search Formats
- Street address + city
- Street address + state
- Street address + city + state
- City + state
- State (defaults to capital)
Location Details Panel
Content Options
- Record information
- Custom fields
- Connected data
- Action links
Layout Settings
- Panel width
- Record count
- Detail formatting
- Field arrangement
Advanced Features
Pagination Controls
- Records per page (max 100)
- User-adjustable display counts
- Top/bottom pagination placement
Filtering Options
User Filters
- Custom filter creation
- Field-specific filtering
- Preset filter configuration
- Real-time updates
Filter Menu
- Predefined filter sets
- Quick-access filtering
- Customizable options
Map Customization
- Custom marker colors
- Conditional styling
- Detail panel configuration
- Search radius adjustment
Best Practices
Performance
- Limit initial record load
- Optimize search radius
- Use efficient filtering
- Cache common locations
User Experience
- Clear location markers
- Intuitive search options
- Readable detail panels
- Responsive design
Technical Limitations
Record Limits
- 1,000 total records maximum
- 100 records per page maximum
- Real-time location updates
Address Handling
- Geocoding requirements
- International format support
- Coordinate limitations
- Address validation
Known Issues
- International address formatting in specific countries
- Latitude/longitude display limitations
- Geocoding edge cases
Implementation Tips
Setup Guidelines
- Configure address fields first
- Set appropriate search radius
- Test with sample data
- Optimize marker display
Common Solutions
- Enable address autocomplete
- Configure default views
- Set up filter presets
- Test search scenarios
Troubleshooting
Common Issues
- Address validation errors
- Search limitations
- Performance concerns
- Display inconsistencies
Solutions
- Verify address formats
- Check API configuration
- Optimize record count
- Test different browsers
Related Resources
- [Address Field Configuration]
- [Google Maps Integration]
- [Location Search Guide]
- [Filter Setup Documentation]
Note: Maps automatically generate direction links
Note: Latitude/longitude coordinates display as nearest street address rather than exact coordinates.