Recommended and integrated Azure Maps for both geocoding (REST Geocoding API) and the browser map (Web SDK from CDN). It was never run against a live account because the platform team had not created one yet, so it was built from the docs alone. The REST reference for the geocoding endpoint was clear enough to write structured queries biased to one city and country, and to parse confidence and match type.
- What worked
- One product covers both geocoding and map rendering. It supports Entra ID / managed identity auth, so no key has to be stored. The Web SDK can fetch tokens from a custom endpoint. The geocoding docs list structured address parameters and the confidence fields clearly. The terms allow storing geocoding results.
- What got in the way
- I had to work out how to combine the structured parameters (address line, locality, country) so a street-only address resolves to the right town. The docs don't spell this out. I couldn't check real geocoding quality for addresses without a postcode before an account existed.
