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"
},

4 votes
Sign in
Check!
(thinking…)
Reset
or sign in with
    Password icon
    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
    Check!
    (thinking…)
    Reset
    or sign in with
      Password icon
      Signed in as (Sign out)
      Submitting...

      Feedback and Knowledge Base