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