API Reference

Geocode

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Batch geocode multiple addresses

geocode().batch(GeocodeBatchParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : GeocodeBatchResponse

POST/api/v1/geocode/batch

Batch geocode multiple addresses

ParametersExpand Collapse

params: GeocodeBatchParams

addresses: List<String>

ReturnsExpand Collapse

class GeocodeBatchResponse:

Batch geocoding result. Each entry in results is a FeatureCollection corresponding to the input address at the same index. Order is preserved.

count: Long

Number of addresses processed (always equals length of results)

results: List<GeocodeResult>

Array of FeatureCollections, one per input address. Empty FeatureCollections indicate no match.

features: List<GeocodingFeature>

Geocoding results ordered by relevance score

geometry: GeoJsonGeometry

GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.

coordinates: Coordinates

Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.

One of the following:

List<Double>

List<List<Double>>

List<List<List<Double>>>

List<List<List<List<Double>>>>

type: Type

Geometry type

One of the following:

POINT("Point")

LINE_STRING("LineString")

POLYGON("Polygon")

MULTI_POINT("MultiPoint")

MULTI_LINE_STRING("MultiLineString")

MULTI_POLYGON("MultiPolygon")

properties: Properties

Geocoding result properties

displayName: String

Formatted address or place name

category: Optional<String>

POI category (e.g. restaurant, cafe, park). Present for place results.

city: Optional<String>

City or town name. Present for address results.

confidence: Optional<Double>

Interpolation confidence (0-1). Present only for interpolated results.

maximum1

minimum0

country: Optional<String>

Country name. Present for reverse geocode address results.

countryCode: Optional<String>

ISO 3166-1 alpha-2 country code

maxLength2

minLength2

distanceM: Optional<Double>

Distance from the query point in meters (reverse geocode / nearby only)

fullAddress: Optional<String>

Complete formatted address from the database. Present for reverse geocode address results.

houseNumber: Optional<String>

House or building number. Present for address and interpolated results.

interpolated: Optional<Boolean>

Whether this result was estimated by address interpolation rather than an exact database match.

name: Optional<String>

Place name (raw). Present for reverse geocode place results.

osmId: Optional<Long>

OpenStreetMap element ID (null for interpolated results)

osmType: Optional<OsmType>

OSM element type (node, way, relation)

One of the following:

NODE("node")

WAY("way")

RELATION("relation")

postcode: Optional<String>

Postal code. Present for reverse geocode address results.

score: Optional<Double>

Relevance score (higher is better). Incorporates text match quality, spatial proximity boost, and popularity signals. Not bounded to 0-1.

minimum0

source: Optional<Source>

Result source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)

One of the following:

STRUCTURED("structured")

BM25("bm25")

FUZZY("fuzzy")

ADDRESS("address")

PLACE("place")

INTERPOLATION("interpolation")

state: Optional<String>

State or province name. Present for reverse geocode address results.

street: Optional<String>

Street name. Present for address and interpolated results.

subcategory: Optional<String>

POI subcategory. Present for place results.

tags: Optional<Tags>

Raw OSM tags. Present for place results.

wikipedia: Optional<String>

Wikipedia article reference (e.g. en:Eiffel Tower). Present for notable places.

type: Type

type: Type

Batch geocode multiple addresses

Kotlin

HTTP

TypeScript

Python

Java

Kotlin

Go

Ruby

CLI Tool

PHP

C#

package com.plazafyi.example

import com.plazafyi.client.PlazaClient
import com.plazafyi.client.okhttp.PlazaOkHttpClient
import com.plazafyi.models.geocode.GeocodeBatchParams
import com.plazafyi.models.geocode.GeocodeBatchResponse

fun main() {
    val client: PlazaClient = PlazaOkHttpClient.fromEnv()

    val params: GeocodeBatchParams = GeocodeBatchParams.builder()
        .addAddress("string")
        .build()
    val response: GeocodeBatchResponse = client.geocode().batch(params)
}

200 example

{
  "count": 0,
  "results": [
    {
      "features": [
        {
          "geometry": {
            "coordinates": [
              2.3522,
              48.8566
            ],
            "type": "Point"
          },
          "properties": {
            "display_name": "221B Baker Street, London, NW1 6XE, United Kingdom",
            "category": "restaurant",
            "city": "London",
            "confidence": 0,
            "country": "United Kingdom",
            "country_code": "GB",
            "distance_m": 0,
            "full_address": "221B Baker Street, London, NW1 6XE, United Kingdom",
            "house_number": "221B",
            "interpolated": true,
            "name": "Eiffel Tower",
            "osm_id": 21154906,
            "osm_type": "node",
            "postcode": "NW1 6XE",
            "score": 0,
            "source": "structured",
            "state": "England",
            "street": "Baker Street",
            "subcategory": "italian",
            "tags": {
              "foo": "string"
            },
            "wikipedia": "en:Eiffel Tower"
          },
          "type": "Feature"
        }
      ],
      "type": "FeatureCollection"
    }
  ]
}

Returns Examples

200 example

{
  "count": 0,
  "results": [
    {
      "features": [
        {
          "geometry": {
            "coordinates": [
              2.3522,
              48.8566
            ],
            "type": "Point"
          },
          "properties": {
            "display_name": "221B Baker Street, London, NW1 6XE, United Kingdom",
            "category": "restaurant",
            "city": "London",
            "confidence": 0,
            "country": "United Kingdom",
            "country_code": "GB",
            "distance_m": 0,
            "full_address": "221B Baker Street, London, NW1 6XE, United Kingdom",
            "house_number": "221B",
            "interpolated": true,
            "name": "Eiffel Tower",
            "osm_id": 21154906,
            "osm_type": "node",
            "postcode": "NW1 6XE",
            "score": 0,
            "source": "structured",
            "state": "England",
            "street": "Baker Street",
            "subcategory": "italian",
            "tags": {
              "foo": "string"
            },
            "wikipedia": "en:Eiffel Tower"
          },
          "type": "Feature"
        }
      ],
      "type": "FeatureCollection"
    }
  ]
}