Skip to content

Location lookups and map rendering have separate setup. You can get coordinates for an address without loading a street map.

Look up an address

In the Project, open Services, select Maps, and check the provider for geocoding. Run the lookup from the application backend with its runtime URL and key. Give each lookup a new request identifier.

request_id=$(uuidgen)
curl --fail-with-body "$PLAYBOOKS_MAPS_URL/v1/application/geocoding/forward" \
  -H "Authorization: Bearer $PLAYBOOKS_MAPS_KEY" \
  -H 'Content-Type: application/json' \
  --data "$(jq -n --arg id "$request_id" '{address: "1 Ferry Building, San Francisco, CA", idempotencyKey: $id}')"

Inspect data.results for a matching formatted address and location. Use the matching coordinates for a marker. MapLibre can display your own data without a basemap. For street detail, configure an authorized style or tile source.

Configure a runtime Site

Open Configuration → Maps on the Site. Review the provider and status separately for maps, places, geocoding, and routes. A Site manager can select an available provider for each. Verify a lookup from the released application before relying on it. The backend lookup above requires a credential with Project and deploy context.