The map or address suggestions are not working
The map is blank, addresses do not suggest, or distances come back as straight-line estimates. Usually a Google key or setting.
The app uses two Google keys: a server key for distances, drive times and address lookups, and a browser key that draws the map on screen.
Likely causes, in order
- The server key is missing or refused. Open Settings, System, Connections, Services and the Google Maps card. Paste the server key if it is empty, then press Test the key. It should say Google accepted an address lookup.
- The map does not draw, but distances work. The browser key is missing or not allowed on your web address. In Google Cloud, the browser key must allow the Maps JavaScript API and list your app's address under Websites. The browser key is set where your site is hosted, not in the app; after setting it the site has to be deployed again. On a hosted plan, contact support.
- One of the four Google services is not switched on. In Google Cloud, APIs and Services, check Geocoding API, Places API (New), Routes API and Maps JavaScript API are all enabled.
- Google billing is not set up, or is on hold. Google needs a billing account even inside the free allowance.
- The daily cap was reached. If you set a daily limit, the app falls back to straight-line estimates for the rest of the day rather than stopping. A distance then says "Straight-line estimate".
- "The warehouse has no map location yet." An admin sets it under Settings, Operations, Dispatch, on the Routing tab.
- Street View says "Google has no street picture near this address." Google has no street picture within about 1,000 ft of the address (a farm, a park, a new street). Press Open Street View to look around in Google Maps, or use Satellite. If it says Google could not place the address, check the street and ZIP. Both are written to the error log under Settings, Tools, Logs.
Good to know
- The setup walkthrough for Google Maps shows every click. See Google Maps.
- Settings, Tools, Health tests the Maps key under Connections with Test now.
Still stuck? Tell us what you pressed and what you saw. A person reads every message.
Contact support