Skip to content
Plaza Plaza Docs
GuidesPlaygroundDashboard
API Reference
Geocode

Autocomplete a partial address

AutocompleteResult geocode().autocomplete(GeocodeAutocompleteParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/api/v1/geocode/autocomplete

Autocomplete a partial address

ParametersExpand Collapse
GeocodeAutocompleteParams params
String q

Partial address query

Optional<String> countryCode

ISO 3166-1 alpha-2 country code filter

Optional<String> lang

Language code for localized names (e.g. en, de, fr)

Optional<Double> lat

Focus latitude

Optional<String> layer

Filter by layer: address, poi, or admin

Optional<Long> limit

Maximum results (default 10, max 20)

Optional<Double> lng

Focus longitude

ReturnsExpand Collapse
class AutocompleteResult:

GeoJSON FeatureCollection of autocomplete suggestions

List<GeocodingFeature> features
Coordinates coordinates

GeoJSON coordinates array (nesting depth varies by geometry type)

One of the following:
List<double>
List<List<double>>
List<List<List<double>>>
List<List<List<List<double>>>>
Type type
One of the following:
POINT("Point")
LINE_STRING("LineString")
POLYGON("Polygon")
MULTI_POINT("MultiPoint")
MULTI_LINE_STRING("MultiLineString")
MULTI_POLYGON("MultiPolygon")
Properties properties
Optional<String> countryCode

ISO 3166-1 alpha-2 country code

Optional<String> displayName

Formatted address or place name

Optional<Double> distanceM

Distance in meters

Optional<Long> osmId

OpenStreetMap ID

Optional<String> osmType

OSM element type

Optional<Double> score

Match confidence score

Optional<String> source

Result source (address, place, interpolation)

Type type
Type type

Autocomplete a partial address

package com.plazafyi.example;

import com.plazafyi.client.PlazaClient;
import com.plazafyi.client.okhttp.PlazaOkHttpClient;
import com.plazafyi.models.geocode.AutocompleteResult;
import com.plazafyi.models.geocode.GeocodeAutocompleteParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        PlazaClient client = PlazaOkHttpClient.fromEnv();

        GeocodeAutocompleteParams params = GeocodeAutocompleteParams.builder()
            .q("q")
            .build();
        AutocompleteResult autocompleteResult = client.geocode().autocomplete(params);
    }
}
Returns Examples