Summary

This article covers geocoding and map service configuration in TRBOnet, including Google Geocoding API, OSM Nominatim, Google Maps Static/JavaScript APIs, and the URLs used by supported map and geocoding services.

TRBOnet sends a geocoding request when hovering over a radio or map object with coordinates, using Find on Map, generating reports that include street names, or performing any action that requires address lookup.

Google Geocoding API

TRBOnet supports Google Geocoding API for address lookup and reverse geocoding. A valid Google API key is required.

1. Obtain a Google Geocoding API key.

2. Verify that the key works by opening the URL in a browser after adding your key to it. The example below is for Washington, D.C.:

https://maps.googleapis.com/maps/api/geocode/xml?address=washington&key=API_KEY

The response must contain status OK.

3. Open TRBOnet Server Configurator.

4. Go to the Geocoding Servers tab.

5. Select Google and click Edit or double-click the provider to open its settings.

6. Add the API key at the end of each URL:

https://maps.googleapis.com/maps/api/geocode/xml?latlng={lat},{lon}&key=API_KEY

https://maps.googleapis.com/maps/api/geocode/xml?address={address}&key=API_KEY

7. You can click Test and verify key functionality.

8. Apply settings.

9. In the Console, disable all geocoding providers to ensure that all Consoles receive geocoding data from the Server.

OSM Nominatim Geocoding API

OSM Nominatim changed its request requirements. TRBOnet implements the required changes starting from version 6.2.2.7485 and newer.

Keep the parameter Request a place name upon receiving GPS coordinates unchecked to reduce the number of geocoding requests.

Local or Third-Party Geocoding Servers

To avoid usage limits imposed by external geocoding services, you can deploy your own local geocoding server. TRBOnet can use TRBOnet Map Server or other open-source solutions such as Nominatim.

TRBOnet does not provide support for installing or maintaining non-TRBOnet geocoding servers or third-party API services.

URLs Used by Geocoding Services

Map Services

Google Map API

TRBOnet uses Google Maps Static API for Location Tracking and Google Maps JavaScript API for Web Console.

Add API Key for Google Maps

1. Open the Dispatch Console.

2. Go to Map → Map content and select a Google map type.

3. Enter the API key:

4. Go to Map → Open new map in tab.

5. Select the required Google map type such as Hybrid and click OK.

Web Console Google Maps

2. Open the deployed Web Console root folder.

3. Edit Default.aspx.

4. Add the key to the script tag:

https://maps.google.com/maps/api/js?key=API_KEY

5. Select the required Google map type in the Web Console.

OSM Mapnik

TRBOnet complies with the OSM Tile Usage Policy starting with version 6.4.1.8767.

Tile policy: https://operations.osmfoundation.org/policies/tiles/

URLs Used by Map Services

Obsolete Map Services