POI Nearby Search

The POI Nearby API returns points of interest of a specific category using either: a point + radius (proximity search), or a bounding box (viewport search). Results include the name, distance, coordinates, and address of each matching venue.

Click anywhere on the map — or type coordinates below — then select a category and radius to search. Categories use raw OSM key:value tags. Results will be empty for oceans or locations outside the coverage area.

This API is ideal for powering “restaurants near me” searches using amenity:restaurant, or finding supermarkets in a city (e.g. Mérida, Mexico at 20.960, -89.614) using shop:supermarket.

Bounding Box Search

In addition to point + radius searches, you can query POIs within a rectangular area using a bounding box. This is useful for map viewport queries or retrieving all POIs within a visible region.

curl -H "X-API-Key: $API_KEY" \
            "https://api.oncoord.com/v1/poi_nearby?category=shop:supermarket&boundary.rect.min_lat=9.927&boundary.rect.max_lat=9.947&boundary.rect.min_lon=-84.123&boundary.rect.max_lon=-84.103"

Bounding box parameters:

boundary.rect.min_lat — southern latitude
boundary.rect.max_lat — northern latitude
boundary.rect.min_lon — western longitude
boundary.rect.max_lon — eastern longitude

The bounding box must not exceed the maximum allowed size (100 km per side).

What the Response Tells You

{
  "total": 2,
  "results": [
    {
      "name": "Domino's",
      "category": ["food", "retail", "amenity:fast_food", "cuisine:pizza"],
      "distance_m": 724,
      "center_point": { "lon": -93.103771, "lat": 16.75194 },
      "address": { "zip": "29000" }
    },
    ...
  ]
}

total — number of matching venues found within the search radius.

name — the venue name.

category — all tags assigned to the venue. The queried category will always be present; additional tags provide broader context (e.g. a pizza restaurant will also carry food and retail).

distance_m — straight-line distance in metres:

from the queried point (for point + radius searches)
from the center of the bounding box (for bounding box searches)

center_point — the coordinates of the venue.

address — partial address data where available. Coverage varies by country and data quality.

POI Nearby Search

Bounding Box Search

What the Response Tells You

API Call

cURL Command