Location and Area Types
Note
Bing Maps for Enterprise service retirement
Bing Maps for Enterprise is deprecated and will be retired. Free (Basic) account customers can continue to use Bing Maps for Enterprise services until June 30th, 2025. Enterprise account customers can continue to use Bing Maps for Enterprise services until June 30th, 2028. To avoid service disruptions, all implementations using Bing Maps for Enterprise REST APIs and SDKs will need to be updated to use Azure Maps by the retirement date that applies to your Bing Maps for Enterprise account type.
Azure Maps is Microsoft's next-generation maps and geospatial services for developers. Azure Maps has many of the same features as Bing Maps for Enterprise, and more. To get started with Azure Maps, create a free Azure subscription and an Azure Maps account. For more information about azure Maps, see Azure Maps Documentation. For migration guidance, see Bing Maps Migration Overview.
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 |