Location and Area Types


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



Values and Syntax


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.


Use the following ranges of values:

  • Latitude (degrees): [-90, +90]

  • Longitude (degrees): [-180,+180]

Example: 47.610679194331169,-122.10788659751415


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


Details about a point on the Earth that has additional location information.

An address can contain the following fields: address line, locality, neighborhood, admin district, admin district 2, formatted address, postal code and country or region. For descriptions see the Address Fields section below.




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


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.

Example: Seattle


A string specifying the neighborhood for an address.

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

Example: Ballard


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


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


A string specifying the complete address. This address may not include the country or region.

Example: 1 Microsoft Way, Redmond, WA 98052-8300


A string specifying the post code, postal code, or ZIP Code of an address.

Example: 98178


A string specifying the country or region name of an address.

Example: United States


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


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

Example: Eiffel Tower