Geodata Determination
1. General
The Geodata Determination setting enables the automatic determination of geographic coordinates (latitude/longitude) for address records in brainX. The coordinates are used, for example, to display records on a map or for route optimization.
The geodata determination uses the Google Maps Geocoding API. Both a Geocoding API key and a JavaScript Maps API key are required.
2. Configuration
2.1. Google Maps API Keys
To use geodata determination, two API keys from Google Cloud Console are required:
| Field | Description |
|---|---|
| Geocoding API Key | Used for converting addresses to coordinates (server-side) |
| JavaScript Maps API Key | Used for displaying maps in the brainX interface (client-side) |
Instructions for creating Google Maps API keys can be found in the Google Cloud documentation.
2.2. Setting Up the API Keys
- Enter the Geocoding API Key in the corresponding field
- Enter the JavaScript Maps API Key in the corresponding field
- Save the settings
After saving, geodata determination is active for the client.
3. Background Task
The geodata determination runs as a background task and processes address records continuously. New or changed address records are added to the processing queue and their coordinates are determined automatically.
The status of the background task can be checked in the Background Tasks overview.
4. Practical Examples
Example 1: Address Record with Map Display
After entering an address in a contact or organization record and saving, the background task determines the coordinates for this address. The record is then displayed as a pin on the map view.
Example 2: Route Planning
If multiple records with determined coordinates are selected in the list view, a route can be planned via the map display. The order of the stops can be adjusted as needed.
5. FAQ
Q: How long does it take until coordinates are determined for a new address?
A: The processing usually takes a few minutes, depending on the processing queue. Urgent records can be prioritized via a manual trigger.
Q: What happens when an address is changed?
A: When an address is changed and saved, the geodata are automatically recalculated by the background task.
Q: Are there costs for using the Google Maps API?
A: Yes, Google charges for use of the Geocoding API beyond a certain monthly free volume. Information about the current pricing can be found in the Google Cloud pricing overview.
Q: Can addresses outside of Germany also be geocoded?
A: Yes, the Google Maps Geocoding API supports addresses worldwide.