PointsOfInterest

The PointsOfInterest data source contains information about points of interest (POIs) for over 150 countries worldwide. POI coverage varies by country. You can query this data source by using the Bing Spatial Data Services Query API and any Bing Maps Key.

Note

For migrating from the deprecated NAVTEQNA and NAVTEQEU data sources to the superceding PointsOfInterest data source, simply remove the accessID (i.e.: 'f22876ec257b474b82fe2ffcb8393150'), change dataSourceName from 'NavteqNA' or 'NavteqEU' to 'Microsoft' and change entityTypeName from 'NavteqPOIs' to 'PointsOfInterest' in the base query URL. An example base query URL for the PointsOfInterest data source is documented below.

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