API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Geocode

Forward geocode an address

$ plaza geocode forward

GET/api/v1/geocode

Reverse geocode a coordinate

$ plaza geocode reverse

GET/api/v1/geocode/reverse

Autocomplete a partial address

$ plaza geocode autocomplete

GET/api/v1/geocode/autocomplete

Batch geocode multiple addresses

$ plaza geocode batch

POST/api/v1/geocode/batch

ModelsExpand Collapse

autocomplete_result: object { features, type }

GeoJSON FeatureCollection of autocomplete suggestions

features: array of GeocodingFeature { geometry, properties, type }

geometry: object { coordinates, type }

coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of number

GeoJSON coordinates array (nesting depth varies by geometry type)

union_member_0: array of number

union_member_1: array of array of number

union_member_2: array of array of array of number

union_member_3: array of array of array of array of number

type: "Point" or "LineString" or "Polygon" or 3 more

"Point"

"LineString"

"Polygon"

"MultiPoint"

"MultiLineString"

"MultiPolygon"

properties: object { country_code, display_name, distance_m, 4 more }

country_code: optional string

ISO 3166-1 alpha-2 country code

display_name: optional string

Formatted address or place name

distance_m: optional number

Distance in meters

osm_id: optional number

OpenStreetMap ID

osm_type: optional string

OSM element type

score: optional number

Match confidence score

source: optional string

Result source (address, place, interpolation)

type: "Feature"

"Feature"

type: "FeatureCollection"

"FeatureCollection"

geocode_result: object { features, type }

GeoJSON FeatureCollection of geocoding results

features: array of GeocodingFeature { geometry, properties, type }

geometry: object { coordinates, type }

coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of number

GeoJSON coordinates array (nesting depth varies by geometry type)

union_member_0: array of number

union_member_1: array of array of number

union_member_2: array of array of array of number

union_member_3: array of array of array of array of number

type: "Point" or "LineString" or "Polygon" or 3 more

"Point"

"LineString"

"Polygon"

"MultiPoint"

"MultiLineString"

"MultiPolygon"

properties: object { country_code, display_name, distance_m, 4 more }

country_code: optional string

ISO 3166-1 alpha-2 country code

display_name: optional string

Formatted address or place name

distance_m: optional number

Distance in meters

osm_id: optional number

OpenStreetMap ID

osm_type: optional string

OSM element type

score: optional number

Match confidence score

source: optional string

Result source (address, place, interpolation)

type: "Feature"

"Feature"

type: "FeatureCollection"

"FeatureCollection"

geocoding_feature: object { geometry, properties, type }

geometry: object { coordinates, type }

coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of number

GeoJSON coordinates array (nesting depth varies by geometry type)

union_member_0: array of number

union_member_1: array of array of number

union_member_2: array of array of array of number

union_member_3: array of array of array of array of number

type: "Point" or "LineString" or "Polygon" or 3 more

"Point"

"LineString"

"Polygon"

"MultiPoint"

"MultiLineString"

"MultiPolygon"

properties: object { country_code, display_name, distance_m, 4 more }

country_code: optional string

ISO 3166-1 alpha-2 country code

display_name: optional string

Formatted address or place name

distance_m: optional number

Distance in meters

osm_id: optional number

OpenStreetMap ID

osm_type: optional string

OSM element type

score: optional number

Match confidence score

source: optional string

Result source (address, place, interpolation)

type: "Feature"

"Feature"

reverse_geocode_result: object { features, type }

GeoJSON FeatureCollection of reverse geocoding results

features: array of GeocodingFeature { geometry, properties, type }

geometry: object { coordinates, type }

coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of number

GeoJSON coordinates array (nesting depth varies by geometry type)

union_member_0: array of number

union_member_1: array of array of number

union_member_2: array of array of array of number

union_member_3: array of array of array of array of number

type: "Point" or "LineString" or "Polygon" or 3 more

"Point"

"LineString"

"Polygon"

"MultiPoint"

"MultiLineString"

"MultiPolygon"

properties: object { country_code, display_name, distance_m, 4 more }

country_code: optional string

ISO 3166-1 alpha-2 country code

display_name: optional string

Formatted address or place name

distance_m: optional number

Distance in meters

osm_id: optional number

OpenStreetMap ID

osm_type: optional string

OSM element type

score: optional number

Match confidence score

source: optional string

Result source (address, place, interpolation)

type: "Feature"

"Feature"

type: "FeatureCollection"

"FeatureCollection"