▣ GEOLOCATION · STANDARD DATA

Find US Places in Bounding Box API

What it does

Places in Bounding Box returns places that fall within a latitude and longitude rectangle. Send min_lat, min_lon, max_lat, and max_lon, and optionally set limit to control how many results come back.

Use Places in Bounding Box when you need location-aware search over a map area instead of a single point. It fits workflows like showing nearby businesses on a map, filtering points of interest for a region, or narrowing a search to a delivery zone, service area, or neighborhood boundary.

The response is an object with additional properties, so you can inspect the returned place data in the format provided by the endpoint. The bounding box inputs follow normal coordinate ranges: latitude between -90 and 90, longitude between -180 and 180, with limit capped at 500.

If your application already knows the area on the map, Places in Bounding Box gives you the fastest way to retrieve matching places for that region without doing extra geospatial filtering on your side.

▣ ENDPOINT 01 / 02

GET

Places in bounding box

https://api.eu.apyhub.com/dosvak/places-in-bounding-box

QUICKSTART

GUIDE

Quickstart

Find places inside a bounding box by providing the required latitude and longitude bounds as query parameters.

curl -X GET "https://api.eu.apyhub.com/dosvak/places-in-bounding-box?min_lat=34.04&min_lon=-118.26&max_lat=34.07&max_lon=-118.22" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the matching places for the specified bounding box, along with related metadata.

{
  "input": {
    "min_lat": 34.04,
    "min_lon": -118.26,
    "max_lat": 34.07,
    "max_lon": -118.22,
    "limit": 3
  },
  "count": 1,
  "results": [
    {
      "osm_id": 123456,
      "name": "Union Station",
      "category": "railway",
      "lat": 34.056,
      "lon": -118.236
    }
  ],
  "attribution": []
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns places that fall within a bounding box defined by latitude and longitude limits. You provide the minimum and maximum latitude/longitude values, and can optionally limit how many places are returned.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: `100`. Minimum: `1`. Maximum: `500`.
max_lat	Number	Yes	Maximum latitude of the bounding box. Range: `-90` to `90`.
max_lon	Number	Yes	Maximum longitude of the bounding box. Range: `-180` to `180`.
min_lat	Number	Yes	Minimum latitude of the bounding box. Range: `-90` to `90`.
min_lon	Number	Yes	Minimum longitude of the bounding box. Range: `-180` to `180`.

Response

Returns a JSON object containing the matching places for the specified bounding box. The response may include additional place details and metadata.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 100

max_latREQUIRED

number

—

max_lonREQUIRED

number

—

min_latREQUIRED

number

—

min_lonREQUIRED

number

—

▣ ENDPOINT 02 / 02

GET

Geospatial backend status

https://api.eu.apyhub.com/dosvak/places-in-bounding-box/status

QUICKSTART

GUIDE

Quickstart

Check the geospatial backend status with a simple GET request.

curl -X GET "https://api.eu.apyhub.com/dosvak/places-in-bounding-box/status" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The response schema doesn't declare any specific top-level fields, so the shape may include additional properties.

{}

TRY ITLIVE · 1 ATOM

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

This endpoint returns a JSON object describing the geospatial backend status. The response shape is not yet defined in the schema beyond being an object.

Response

Returns a JSON object. The schema does not define any top-level fields yet, so the exact response members are not documented here.

Parameters

No parameters.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.