Near POI Find places nearby

BeMap name: Near POI

POST/nearpoi/1.0

The points of interest around a position, such as fuel stations, restaurants or car parks, limited by the distance to travel to them.

The whole description

In BeMap's words

Find POI around a coordinate, limited by distance of travel from coordinate to POI.

Provisioned per account. This service is enabled per account; without it BeMap answers 400 with Access Denied.

Request body

JSON, Content-Type: application/json. Schema NearPoiRequest.

coordinateCoordinateSatrequired
Coordinate of center of research, will be used with distance parameter.
CoordinateSat fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.
- headingnumber (double)
  Heading in degrees.
- speednumber (float)
  Speed in km/h.
- timeinteger (int64)
  GPS time in milliseconds (EPOCH).
- satinteger (int32)
  Number of GPS satellites available.
distanceinteger (int64)required
Limit of research in meters.
geoserverstring
Geoserver name.
swidxinteger (int32)deprecated
Switch index.

transportTypeenum

Define the transportation mode: Car, pedestrian, truck, etc. By default PEDESTRIAN.

9 accepted values

`PEDESTRIAN`	Pedestrian.
`BICYCLE`	Bicycle.
`MOTORCYCLE`	Motorcycle.
`CAR`	Passenger car.
`TAXI`	Taxi.
`PUBLIC_BUS`	Public bus.
`EMERGENCY`	Emergency vehicle.
`DELIVERY_TRUCK`	Delivery truck. Deprecated, use `TRUCK` instead.
`TRUCK`	Truck.

orderByenum
Sort the result by distance or duration in either ascending or descending. Disable by default.
4 accepted values
DISTANCE_ASC Sort by distance in either ascending.
DISTANCE_DESC Sort by distance in either descending.
DURATION_ASC Sort by duration in either ascending.
DURATION_DESC Sort by duration in either descending.
plboolean
Enable the output polyline geometry of route. Set to true to enable otherwise false. Disable by default.
eplboolean
Enable the output encoded polyline geometry of route with Google Algorithm. Set to true to enable otherwise false. Disable by default.
serviceCategoriesstring[]
Service categories. POI Class ID (numeric value defining the type of service, see the Class ID list in Glossary menu).

Response

200, schema NearPoiResponse.

Response fields

poisNearPoint[]
Points of interests.
NearPoint fields
- coordinateCoordinate
  Geographical coordinate of POI.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- distanceinteger (int64)
  Distance of travel in meters between the input coordinate and POI.
- durationinteger (int64)
  Duration of travel in seconds between the input coordinate and POI.
- typestring
  Type of POI.
- namestring
  Name of POI.
- telephonestring
  Phone number of POI.
- commentstring
  Comment.
- polylineCoordinateFullName[]
  Polyline geometry of route between start coordinate and the POI.
  CoordinateFullName fields
  - longitudenumber (double)required
    Longitude in degrees decimal (WGS84) (double).
  - latitudenumber (double)required
    Latitude in degrees decimal (WGS84) (double).
  - altitudenumber (double)
    Altitude in meters.
- encodedPolylinestring
  Polyline geometry of route between start coordinate and the POI. It is a composed of coordinates list and encoded with Google Algorithm.

Errors

400 Bad Request, ErrorResponse
302 No credentials were sent. Do not follow the redirect.
401 The account or the API key is wrong.

How to read each one: Errors.

Reference pages

Near POI

curl -X POST 'https://bemap.benomad.com/bgis/service/nearpoi/1.0' \ -u 'YOUR_ACCOUNT:YOUR_API_KEY' \ --fail-with-body \ -H 'Content-Type: application/json' \ -d '{ "coordinate": { "lat": 48.8606, "lon": 2.3376 }, "distance": 1000, "transportType": "CAR", "orderBy": "DISTANCE_ASC" }'

{ "pois": [ { "coordinate": { "lon": 2.33623, "lat": 48.86105 }, "distance": 112, "duration": 20, "type": "THEATRE", "name": "Auditorium du Louvre", "telephone": "+(33)-1-40205455" }, { "coordinate": { "lon": 2.33644, "lat": 48.86238 }, "distance": 164, "duration": 31, "type": "COMMUTER_RAIL_STATION", "name": "Métro-Palais Royal Musée du Louvre", "telephone": "" } ] }

Write the code that calls the BeMap API operation "Near POI": POST https://bemap.benomad.com/bgis/service/nearpoi/1.0 - Authenticate with HTTP Basic: the BeMap account as the user name, the API key as the password. Do not follow redirects: a 302 means the credentials were not sent. - Send JSON (Content-Type: application/json) of type `NearPoiRequest`; it requires `coordinate`, `distance`. - Use only the fields the reference lists: BeMap ignores an unknown field name without an error, so a misspelt field configures nothing. - A 400 with "Access Denied" means the account lacks this service; a 401, a wrong account or key. Reference, with every field and what each value means: https://benomad.com/dev/doc/bemap-api/api/map-context/nearpoi.md

`DISTANCE_ASC`	Sort by distance in either ascending.
`DISTANCE_DESC`	Sort by distance in either descending.
`DURATION_ASC`	Sort by duration in either ascending.
`DURATION_DESC`	Sort by duration in either descending.