Google Maps Integration

Use Google Maps Integration when TMS should calculate coordinates, show routes, or calculate distance and duration from map locations.

Google Maps setup

Before you start

Make sure that:

  • your company has a Google Maps Platform account,
  • billing and the required Google APIs are enabled,
  • an API key is created and restricted according to your security policy,
  • users have permission to maintain TMS Setup and map locations.

How to configure Google Maps

  1. Create or open the Google Maps Platform project.
  2. Enable the APIs required by your TMS process.
  3. Create one Google Maps API key for TMS.
  4. Configure API restrictions, quotas, billing alerts, rotation, and monitoring for that key.
  5. Open TMS Setup.
  6. Select Google Maps as the map provider.
  7. Paste the key into Google Api Key.
  8. Test geocoding on a Map Location.
  9. Test route or distance calculation on a Forwarding Order or Freight Order.

TMS shows one field and stores the entered value in separate encrypted server and browser slots. The same value is used by Business Central service-tier requests and the browser map control. Consequently, TMS currently does not support separate IP-restricted and HTTP-referrer-restricted Google keys. Select restrictions that work for both request paths, and use API restrictions, quotas, rotation, monitoring, and billing alerts to limit exposure.

What Google Maps supports

Capability Use it for
Geocoding Convert address details into coordinates.
Map display Show a location or route on a map.
Distance and duration Estimate route distance and travel time.
Position correction Update coordinates when an address was matched incorrectly.

Good to know

  • Google usage can create costs in your Google account.
  • Restrict API keys. Do not share unrestricted keys with users or external systems.
  • The configured Google key is supplied to the browser control and can be extracted by a browser user. Encryption protects it at rest, not while it is used in the browser.
  • Address quality matters. Clean city, country, postal code, and street data gives better results.
  • Geocoding and routing send address or coordinate data to Google. Review privacy and outbound data transfer before enabling the integration.

Troubleshooting

Problem What to check
Geocoding fails Check API key, enabled APIs, billing, and address quality.
Route is not shown Check coordinates on all required map locations.
Distance is empty Confirm map provider setup and that the document has valid origin and destination locations.
Google returns a permission error Review API restrictions and enabled APIs in Google Cloud.