Primary Administrative Areas
- Every location will have one primary administrative area assigned to it.
- The primary administrative area is designated by the Level: 1 code in the AdministrativeArea block of the response.
- Admin Codes have been derived from the ISO 3166-2 codes, where available, focusing on the principal subdivisions.
- If the principal subdivisions of a particular country are not available, the code "00" will be assigned to all locations in that country. The name of the country will be assigned as the administrative name for any "00" codes.
- In the event that a principal subdivision has not yet had an ISO 3166-2 code assigned to it, a code ranging from "X01" to "X99" will be assigned as a place holder until the official code has been released.
- Each primary administrative area will also include the administrative classification, such as State, Province, etc.
|Country Code||Admin Code||Admin Name||Admin Type|
Supplemental Administrative Areas
- Supplemental Administrative Areas can be used to help distinguish between locations that look similar.
- Each area is assigned a number to describe the scale of the administrative subdivisions for countries. As the Level number increases, the scale of the subdivision will decrease.
- Internationally recognized areas focusing on the secondary subdivisions, where available.
- Level 0
- Used to categorize the Constituent Country, or subcountry, for locations that belong to a country that makes up a part of a larger entity.
- Currently used for locations in the UK to represent England, Scotland, Wales, and Northern Ireland.
- Primary use case - Replace Country Name with Constituent Country Name
- London, United Kingdom
- London, England
- Level 2
- Used to represent secondary subdivisions of the primary administrative areas.
- Primary use case - Include in parentheses after the primary administrative information.
- Miami, Florida, United States
- Miami, Florida (Miami-Dade), United States
- Level 0
|Country Code||Admin Code||City Name||Location Key||Admin Level||Admin Name|
|CA||BC||Vancouver||53286||Level 2||Greater Vancouver|
|IN||MH||Mumbai||204842||Level 2||Mumbai Suburban|
|US||CA||Mountain View||337169||Level 2||Santa Clara|
|US||CA||Mountain View||2274601||Level 2||Contra Costa|