Skip to main content
GET
/
v1
/
places
/
nearby
Find Nearby Places
curl --request GET \
  --url https://api.bookovia.com/v1/places/nearby \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "count": 123,
  "places": [
    {
      "id": "<string>",
      "name": "<string>",
      "category": "<string>",
      "latitude": 123,
      "longitude": 123,
      "address": "<string>",
      "distance_km": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.bookovia.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Places Nearby endpoint returns POIs within a specific distance from a center point, sorted by proximity. It uses H3 spatial indexing for fast radius queries and supports category filtering to find specific types of places.
Uses H3 spatial indexing (resolution 11, ~25m cell size) for sub-100ms query performance across 19.7M POIs.

​
Authentication

This endpoint requires authentication via API key in the X-API-Key header. Required permissions: geocoding:read

​
Request

​
lat
number
required
Center point latitude (-90 to 90)
​
lon
number
required
Center point longitude (-180 to 180)
​
radius
number
required
Search radius in kilometers (0.1 to 10)Maximum 10km for optimal performance
​
categories
string
Filter by category (e.g., “restaurant”, “hotel”, “gas_station”)
​
limit
integer
Maximum number of results (1 to 100)Default: 20

​
Request Example

curl -X GET "https://api.bookovia.com/v1/places/nearby?lat=40.7128&lon=-74.0060&radius=2&categories=restaurant&limit=20" \
  -H "X-API-Key: bkv_test_your_api_key_here"

​
Response

​
success
boolean
Indicates whether the request was successful
​
count
integer
Number of places found within radius
​
places
array
Array of places sorted by distance (nearest first)

​
Response Example

{
  "success": true,
  "count": 15,
  "places": [
    {
      "id": "018a9083-401f-4207-b450-c8ff39626513",
      "name": "Joe's Pizza",
      "category": "restaurant",
      "latitude": 40.7130,
      "longitude": -74.0062,
      "address": "7 Carmine St, New York, NY 10014",
      "distance_km": 0.15
    },
    {
      "id": "018a9083-5b2a-4c19-a320-8f1234567890",
      "name": "The Smith",
      "category": "restaurant",
      "latitude": 40.7135,
      "longitude": -74.0070,
      "address": "55 3rd Ave, New York, NY 10003",
      "distance_km": 0.28
    }
  ]
}

​
Use Cases

Show users what’s around them - restaurants, gas stations, ATMs, etc.
Find services along a route (rest stops, charging stations, food).
Locate nearest hospitals, police stations, or pharmacies.
Help travelers find hotels, restaurants, and attractions near their location.

​
Performance

  • Average Response Time: <150ms
  • H3 Resolution: 11 (~25m cell size)
  • Maximum Radius: 10km (use Places Search for larger areas)