Documentation menu
geocoding
GET/v1/places/{id}/entrances
Access and price
| Auth | An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Metered. Needs a full key; a browser (maps) key is refused. |
|---|---|
| Price | 1 call per request. Class: standard. Published as unit_rules.default in /pricing.json. |
What it does
GET /v1/places/{id}/entrances.
Call it
bash
curl -fsS -X GET "https://api.mapmap.ai/v1/places/{id}/entrances" \
-H "Authorization: Bearer $MAPMAP_KEY"Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | A place id exactly as a first-party place result reports it (properties.id), e.g. osm:w123:poi |
Responses
200
{id, name, lat, lon, entrances, entrances_index, note}. entrances is a list of {lon, lat, kind, wheelchair, access, door, level, ref, name, osm_id, source, confidence, basis}: kind is the OpenStreetMap entrance=* value (main, yes, entry, service, staircase, emergency, exit, home, garage, other); source is osm for a door mapped in OpenStreetMap or estimated for one MapMap inferred (none are served today); confidence (high, medium, low) grades how sure the tie between door and place is, with basis saying what tied them (own_outline, stop_area, address_match, sole_occupant). An empty list means no door is tied to this place, not that it has none. name, lat and lon are the place's own, null when this deployment has no place index400An id longer than 128 bytes
application/problem+json · Problem
401Missing or invalid API key. Also: No key, or a missing, malformed, unknown, revoked or expired one (
unauthorized); the body carries signup, docs and a one-call hint for a free keyapplication/problem+json · Problem
402Beyond the included volume with no way to pay this call: an x402 body naming how to pay (provisional key past its allowance, prepaid balance below the price, or a rejected
X-PAYMENT). Not problem+jsonapplication/json · X402PaymentRequired
403The key may not call this: a browser key outside its scope (
scope-insufficient), a request from an origin the key does not allow (origin-not-allowed), or an account restriction (forbidden)application/problem+json · Problem
404No such place in this deployment's place index
application/problem+json · Problem
429Quota or rate limit exceeded. Also: Per-key rate limit (
rate-limited, with Retry-After), or monthly quota exhausted with no payment path (quota-exceeded)application/problem+json · Problem
501This deployment has no place-entrance index (
entrances-not-enabled)application/problem+json · Problem
504The request did not finish within the gateway's request deadline (
request-timeout)application/problem+json · Problem
Error bodies follow the shared problem model documented on API conventions.
Generated from https://api.mapmap.ai/openapi.json on 2026-11-20 · operationId get_place_entrances