How can we improve Azure Maps?

Add consistent way to get city name from structured address data

When using the freeform search endpoint, address results will have structured fields along with the 'freeformAddress'.

Most parts of the mailing address can be read from existing fields (streetNumber, streetName, countrySubdivision, postalCode) however the city does not seem to be represented consistently.

In some cases the city from the freeform address is the municipalitySubdivision, in others its the countryTertiarySubdivision. As a result, to extract structured address data to use for mailing addresses we have had to resort to parsing the freeformAddress to get the city name from there as it seems to always match the intended mailing address.

I would like there to be a way to access all of the components of the freeform address using the structured fields.

Some example addresses which show different ways to encode the addresses:

"address": {
"streetNumber": "15010",
"streetName": "NE 36th St",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond, Earlmount, Avondale, Ames Lake, Adelaide",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"postalCode": "98052",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "15010 NE 36th St, Redmond, WA 98052",
"countrySubdivisionName": "Washington"
}

"address": {
"streetNumber": "1998",
"streetName": "186th Ave NE",
"municipalitySubdivision": "Redmond, Bellevue",
"municipality": "Redmond, Earlmount, Bellevue, Avondale, Ames Lake, Adelaide",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"postalCode": "98008",
"extendedPostalCode": "980083313",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "1998 186th Ave NE, Redmond, WA 98008",
"countrySubdivisionName": "Washington"
},

6 votes
Sign in
(thinking…)
Sign in with: oidc
Signed in as (Sign out)

We’ll send you updates on this idea

Anonymous shared this idea  ·   ·  Flag idea as inappropriate…  ·  Admin →

0 comments

Sign in
(thinking…)
Sign in with: oidc
Signed in as (Sign out)
Submitting...

Feedback and Knowledge Base