▣ GEOLOCATION

US places Category Breakdown API

What it does

Category Breakdown gives you a count of locations by category inside a geographic bounding box. Send min_lat, min_lon, max_lat, and max_lon, and optionally set limit to control how many categories are returned.

Use it when you need to understand what kinds of places exist in an area before rendering a map, filtering search results, or summarizing local inventory. The response is a JSON object, so you can work with the breakdown directly in your app without extra parsing steps.

Category Breakdown is a good fit for location analytics workflows where the same area needs to be inspected repeatedly at different zoom levels. For example, you can compare restaurant-heavy neighborhoods, measure the density of retail categories around a store site, or build a map legend from the most common place types in view.

The service accepts only bounding-box coordinates and a result limit. It returns a JSON object containing the category breakdown for places within the specified bounding box, along with related metadata.

GET

Category breakdown in bbox

https://api.eu.apyhub.com/dosvak/category-breakdown-in-bbox

QUICKSTART

GUIDE

Quickstart

Call this endpoint with the four required bounding-box coordinates as query parameters to get a category breakdown for that area.

curl -X GET "https://api.eu.apyhub.com/dosvak/category-breakdown-in-bbox?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. The schema does not declare any fixed top-level fields, so the response shape may include additional properties.

{
  "input": {
    "min_lat": 34.04,
    "min_lon": -118.26,
    "max_lat": 34.07,
    "max_lon": -118.22,
    "limit": 1
  },
  "count": 5,
  "results": [
    {
      "category": "footway",
      "feature_count": 5143
    }
  ]
}

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 a category breakdown for places within a bounding box defined by latitude and longitude limits. The request is made with query parameters only.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return.<br>Default: `20`.<br>Minimum: `1`.<br>Maximum: `200`.<br>Example: `5`
max_lat	Number	Yes	Maximum latitude of the bounding box.<br>Minimum: `-90`.<br>Maximum: `90`.<br>Example: `34.07`
max_lon	Number	Yes	Maximum longitude of the bounding box.<br>Minimum: `-180`.<br>Maximum: `180`.<br>Example: `-118.22`
min_lat	Number	Yes	Minimum latitude of the bounding box.<br>Minimum: `-90`.<br>Maximum: `90`.<br>Example: `34.04`
min_lon	Number	Yes	Minimum longitude of the bounding box.<br>Minimum: `-180`.<br>Maximum: `180`.<br>Example: `-118.26`

Response

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

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 20

max_latREQUIRED

number

—

max_lonREQUIRED

number

—

min_latREQUIRED

number

—

min_lonREQUIRED

number

—

▣ 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.