Documentation menu

← Parcels

API reference

Retrieve a parcel tile

GET/v1/parcel/tile/{z}/{x}/{y}

The parcel boundaries in one map tile, as a Mapbox vector tile.

The tile has one layer, parcel. Each feature is a boundary with three properties: id, the parcel's id; number, its primary parcel number; and street_number, the house number of one of its addresses. A parcel with no published number or address has no such property.

Tiles exist at zooms 14 to 16. Draw closer zooms from the zoom 16 tile. A tile holds at most 10,000 parcels.

Tiles cost no credits. Each counts toward the plan's parcel tiles for the month.

Parameters

path

zrequiredinteger
Zoom level. Can range between 14 and 16.
xrequiredinteger
Tile column at zoom z, counted from the west.
yrequiredinteger
Tile row at zoom z, counted from the north.

Responses

200
string
A Mapbox vector tile.
401
ProblemDetail
credential_missing, credential_invalid or credential_expired. The request has no valid credential.
403
ProblemDetail
scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
404
ProblemDetail
no_such_resource. No object has that id.
422
ProblemDetail
parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429
ProblemDetail
rate_limited. The plan's parcel tiles for this month are used up.
501
ProblemDetail
not_available. Parcel data is not available yet.

Example request

curl -X GET 'https://api.placestack.com/v1/parcel/tile/16/18438/25764' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

The rest of parcel.

Next

GET /parcel/{parcel_id}

Retrieve a parcel