Address geocoder

The Address geocoder tool lets you upload a CSV, map your address fields, and fill missing coordinate values by geocoding addresses with Azure Maps or Google Maps.

What you’ll need

• A CSV file containing:
  • either a single address column, or
  • an address column plus optional latitude / longitude columns
• An API key for one of:
  • Azure Maps
  • Google Maps

Step-by-step

1. In the portal, open Tools → Address geocoder
2. Upload your CSV
3. Choose provider (Azure Maps or Google Maps)
4. Map columns
   • map one or more address columns
   • optionally map existing latitude / longitude columns if your CSV already has them
5. Output columns
   • latitude and longitude are always included in the exported CSV
   • optional provider response fields can be selected if you want extra columns
6. Paste your provider API key
7. Click Geocode missing rows

Column mapping

• Map at least one column into the Address fields area.
• If your CSV already contains coordinates, map them to Latitude and Longitude so those rows can be detected and skipped.
• If latitude / longitude are not mapped, the tool appends new latitude / longitude columns to the output.

Azure Maps optional fields

• Optional Azure response fields can be added to the CSV from the Output columns section.
• Examples include match score, address parts, municipality, postal code, and country fields.

Google Maps optional fields

• Optional Google response fields can also be added from the Output columns section.

Output

• Output is a CSV download.
• The output preserves the full input file (all columns).
• Latitude / longitude values are written into the mapped columns when present; otherwise new columns are added.
• Existing rows that already have valid coordinates are preserved.
• Only rows missing coordinates are geocoded.

Map preview

• Geocoded and existing points are shown on the map with different colours.
• Hover over a point to open its popup.
• Click a point to keep the popup open so you can scroll it.
• Click elsewhere on the map to dismiss the pinned popup.
• Point popups show the full CSV row plus a flattened provider response.

Provider notes

Azure Maps

• Use an Azure Maps subscription key.
• If you see CORS errors in the browser console, ensure your Azure Maps account has allowed origins configured for your portal domain (and http://localhost[:port] for local testing).

Google Maps

• The tool uses the Google Maps JavaScript API geocoder (browser-friendly) rather than the Google web service endpoints.
• Ensure your Google Cloud project has billing enabled and the required Maps APIs enabled for your key.

Security note