IN THIS ARTICLE

Third-Party Mapping and Geocoding Services

Save as PDF

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 .

3. Open .

4. Go to the tab.

5. Select and click or 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 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.

Alternatively you can add the API key to each Console manually.

10. Enable

OSM Nominatim Geocoding API

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

Nominatim allows one request per second. Faster requests result in IP banning.

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

Before 6.2.2.7485

Before making any changes create a backup of the TRBOnet Server config file.

1. Stop TRBOnet Server and close Server Configurator.

2. Open

Enterprise: %ProgramData%\Neocom Software\TRBOnet.Enterprise\

3. Locate the line:

<UserAgent>Mozilla/5.0</UserAgent>

4. Replace it with a valid User Agent string, for example:

						 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 YaBrowser/24.4.0.0 Safari/537.36
					

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

Provider	URL
Google Reverse	https://maps.googleapis.com/maps/api/geocode/xml?latlng={lat},{lon}
Google Direct	https://maps.googleapis.com/maps/api/geocode/xml?address={address}
Nominatim Reverse	https://nominatim.openstreetmap.org/reverse?format=xml&lat={lat}&lon={lon}
Nominatim Direct	https://nominatim.openstreetmap.org/search?q={address}&format=xml

Map Services

Google Map API

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

1. Obtain a Google Maps Static 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 Brooklyn Bridge in New York City:

https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&am...

The response will be a tile received by address.

Add API Key for Google Maps

1. Open the .

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

3. Enter the API key:

4. Go to and select .

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

Web Console Google Maps

1. Enable :

2. Open the deployed Web Console root folder.

3. Edit .

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 OSM Tile Usage Policy starting with version 5.7.0.5132.

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

URLs Used by Map Services

Service	URL
MAPNIK	http://tile.openstreetmap.org/
THUNDERFOREST	http://tile.thunderforest.com/
BING	http://t0.tiles.virtualearth.net/tiles/
GOOGLE	https://maps.googleapis.com/maps/api/staticmap

Obsolete Map Services

Service	URL
CYCLE	http://a.tile.opencyclemap.org/cycle/
TRANSPORT	http://a.tile2.opencyclemap.org/transport/
LANDSCAPE	http://a.tile3.opencyclemap.org/landscape/

Third-Party Mapping and Geocoding Services

Geocoding Services

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 .

3. Open .

4. Go to the tab.

5. Select and click or 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 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.

Alternatively you can add the API key to each Console manually.

10. Enable

OSM Nominatim Geocoding API

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

Nominatim allows one request per second. Faster requests result in IP banning.

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

Before 6.2.2.7485

Before making any changes create a backup of the TRBOnet Server config file.

1. Stop TRBOnet Server and close Server Configurator.

2. Open

Enterprise: %ProgramData%\Neocom Software\TRBOnet.Enterprise\

3. Locate the line:

<UserAgent>Mozilla/5.0</UserAgent>

4. Replace it with a valid User Agent string, for example:

						 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 YaBrowser/24.4.0.0 Safari/537.36
					

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

Provider	URL
Google Reverse	https://maps.googleapis.com/maps/api/geocode/xml?latlng={lat},{lon}
Google Direct	https://maps.googleapis.com/maps/api/geocode/xml?address={address}
Nominatim Reverse	https://nominatim.openstreetmap.org/reverse?format=xml&lat={lat}&lon={lon}
Nominatim Direct	https://nominatim.openstreetmap.org/search?q={address}&format=xml

Map Services

Google Map API

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

1. Obtain a Google Maps Static 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 Brooklyn Bridge in New York City:

https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&am...

The response will be a tile received by address.

Add API Key for Google Maps

1. Open the .

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

3. Enter the API key:

4. Go to and select .

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

Web Console Google Maps

1. Enable :

2. Open the deployed Web Console root folder.

3. Edit .

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 OSM Tile Usage Policy starting with version 5.7.0.5132.

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

URLs Used by Map Services

Service	URL
MAPNIK	http://tile.openstreetmap.org/
THUNDERFOREST	http://tile.thunderforest.com/
BING	http://t0.tiles.virtualearth.net/tiles/
GOOGLE	https://maps.googleapis.com/maps/api/staticmap

Obsolete Map Services

Service	URL
CYCLE	http://a.tile.opencyclemap.org/cycle/
TRANSPORT	http://a.tile2.opencyclemap.org/transport/
LANDSCAPE	http://a.tile3.opencyclemap.org/landscape/

Helpful? Yes No

We're glad this article helped.

Thanks for letting us know. What went wrong?

The steps in the article did not resolve my problem

This article did not address what I was searching for

The wording used in this article made it confusing

Other

Please don't include any personal information in your comment.