Store
The store groups points of interest that share a similar lifecycle and management structure. The current POI service only has one store: core, in which all information flows through a centralized management system, resulting in a read-only service.
| API | Description |
|---|---|
| GET v1/store |
GET method to retrieve a list of available stores. The canonical name is included in the response, as are the GET and POST URLs required for querying the data. Finally, the entry point for the three classification options is listed (themes, categories, and POI types). |
Theme
Themes are the top level in a three level classification hierarchy, on top of categories and POI types.
| API | Description |
|---|---|
| GET v1/{StoreName}/themes/{theme} |
GET method to retrieve POI theme information. |
| GET v1/{StoreName}/themes |
GET method to retrieve all available POI themes. |
Category
Categories are the mid level in a three level classification hierarchy, in between themes and POI types.
| API | Description |
|---|---|
| GET v1/{StoreName}/themes/{theme}/categories/{category} |
GET method to retrieve POI category information. |
| GET v1/{StoreName}/themes/{theme}/categories |
GET method to retrieve POI categories for a certain theme. |
| GET v1/{StoreName}/categories/{category} |
GET method to retrieve a POI category. |
| GET v1/{StoreName}/categories |
GET method to retrieve all available POI categories. |
PoiType
POI types are the lowest level in a three level classification hierarchy, below themes and categories.
| API | Description |
|---|---|
| GET v1/{StoreName}/themes/{theme}/categories/{category}/poitypes/{poitype} |
GET method to retrieve POI type information. |
| GET v1/{StoreName}/themes/{theme}/categories/{category}/poitypes |
GET method to retrieve POI types for a certain theme and category combination. |
| GET v1/{StoreName}/categories/{category}/poitypes/{poitype} |
GET method to retrieve POI type information. |
| GET v1/{StoreName}/categories/{category}/poitypes |
GET method to retrieve POI types for a certain category. |
| GET v1/{StoreName}/poitypes/{poitype} |
GET method to retrieve POI type information. |
| GET v1/{StoreName}/poitypes |
GET method to retrieve all available POI types. |
Search
Main entry point for more complex queries.
| API | Description |
|---|---|
| POST v1/{StoreName}/request |
POST method to retrieve POIs. |
Poi
Main entry point for simple queries.
| API | Description |
|---|---|
| GET v1/{StoreName} |
GET method to retrieve POIs. |