PointsOfInterest

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.

The PointsOfInterest data source contains information about points of interest (POIs) for over 150 countries/regions worldwide. POI coverage varies by country/region. You can query this data source by using the Bing Spatial Data Services Query API and any Bing Maps Key. The results are limited to 25 points of interest when using a Basic key. Enterprise keys do not have such limit.

Important

When you query this data source for specific property values, you must include a geographical area to search. This does not apply if you are querying for specific entities using entity ID. See Query by Area and Query by ID for details. POI entities may not be available for every location.
Note: The PointsOfInterest data source does not support the intersects and nearRoute filters.

POI Entity Properties

The following table describes the properties that you can query to get information about worldwide points of interest. These properties make up the PointsOfInterest entity type that is used by the Microsoft data source.

Property Data Type Example Value
EntityID (Primary Key) Edm.String 987654321123456789
Name Edm.String Contoso Cafe
DisplayName Edm.String Contoso Cafe
Latitude Edm.Double 47.610005
Longitude Edm.Double -122.185992
AddressLine Edm.String 1234 Main Street
Locality Edm.String Bellevue
AdminDistrict Edm.String Washington
AdminDistrict2 Edm.String King
PostalCode Edm.String 98004
CountryRegion Edm.String USA
Phone Edm.String +(1)-(425)1231234
EntityTypeID Edm.String 9996

Entity Types

For a complete list of the entity type IDs that you can query, see POI Entity Types.

How to query the PointsOfInterest data source

You can query PointsOfInterest data source by using the following base URL and adding additional parameters such a geographical area to search and the properties you want to return. For a complete description of query options and more examples, see Query API.

Important

When you query this data source for specify property values, you must include a geographical area to search. This does not apply if you are querying for specific entities using entity ID. See Query by Area and Query by ID for details.

Base Query URL

http://spatial.virtualearth.net/REST/v1/data/Microsoft/PointsOfInterest

Query Example

The following query example queries for banks within 5 kilometers of the specified latitude and longitude. The query key you use can be any Bing Maps Key. For complete information about querying a data source, see Query API.

http://spatial.virtualearth.net/REST/v1/data/Microsoft/PointsOfInterest?spatialFilter=nearby(40.83274904439099,-74.3163299560546935,5)&$filter=EntityTypeID%20eq%20'6000'&$select=EntityID,DisplayName,Latitude,Longitude,__Distance&$top=3&key=anyBingMapsKey