Location and Area Types

  • Article

Use the following formats to specify locations and areas on the Earth.

Type Description Values and Syntax
Point A point on the Earth specified by a latitude and longitude. The coordinates are double values that are separated by commas and are specified in the following order.

Latitude,Longitude

Use the following ranges of values:

- Latitude (degrees): [-90, +90]
- Longitude (degrees): [-180,+180]

Example: 47.610679194331169,-122.10788659751415
BoundingBox A rectangular area on the Earth. A bounding box is defined by two latitudes and two longitudes that represent the four sides of a rectangular area on the Earth.

Use the following syntax to specify a bounding box:

South Latitude, West Longitude, North Latitude, East Longitude

Example: 45.219,-122.325,47.610,-122.107
Address Details about a point on the Earth which has additional location information. An address can contain the following fields:

- address line
-locality
-neighborhood
- admin district
- admin district 2
- formatted address
- postal code
- country or region.

For descriptions see the Address Fields section below.

Address Fields

Address Description
addressLine The official street line of an address relative to the area, as specified by the Locality, or PostalCode, properties. Typical use of this element would be to provide a street address or any official address.

Example: 1 Microsoft Way
locality A string specifying the populated place for the address. This typically refers to a city, but may refer to a suburb or a neighborhood in certain countries/regions.

Example: Seattle
neighborhood A string specifying the neighborhood for an address.

You must specify includeNeighborhood=1 in your request to return the neighborhood.

Example: Ballard
adminDistrict A string specifying the subdivision name in the country or region for an address. This element is typically treated as the first order administrative subdivision, but in some cases it is the second, third, or fourth order subdivision in a country, dependency, or region.

Example: WA
adminDistrict2 A string specifying the subdivision name in the country or region for an address. This element is used when there is another level of subdivision information for a location, such as the county.

Example: King
formattedAddress A string specifying the complete address. This address may not include the country or region.

Example: 1 Microsoft Way, Redmond, WA 98052-8300
postalCode A string specifying the post code, postal code, or ZIP Code of an address.

Example: 98178
countryRegion A string specifying the country or region name of an address.

Example: United States
countryRegionIso2 A string specifying the two-letter ISO country code.

You must specify include=ciso2 in your request to return this ISO country code.

Example: US
landmark A string specifying the name of the landmark when there is a landmark associated with an address.

Example: Eiffel Tower