Skip to content
Plaza Plaza Docs
GuidesPlaygroundDashboard
API Reference
Elements

Find features near a geographic point

FeatureCollection elements().nearby(ElementNearbyParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/api/v1/features/nearby

Find features near a geographic point

ParametersExpand Collapse
ElementNearbyParams params
double lat

Latitude (-90 to 90)

double lng

Longitude (-180 to 180)

Optional<Long> limit

Maximum results (default 20, max 100)

Optional<Long> radius

Search radius in meters (default 500, max 10000)

ReturnsExpand Collapse
class FeatureCollection:

Bare GeoJSON FeatureCollection. Pagination metadata is returned in HTTP headers (X-Limit, X-Has-More, X-Next-Cursor, X-Next-Offset, Link).

List<GeoJsonFeature> 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
Type type
Optional<String> id

Feature identifier (type/osm_id)

Optional<Long> osmId

OpenStreetMap ID

Type type

Find features near a geographic point

package com.plazafyi.example;

import com.plazafyi.client.PlazaClient;
import com.plazafyi.client.okhttp.PlazaOkHttpClient;
import com.plazafyi.models.FeatureCollection;
import com.plazafyi.models.elements.ElementNearbyParams;

public final class Main {
    private Main() {}

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

        ElementNearbyParams params = ElementNearbyParams.builder()
            .lat(0.0)
            .lng(0.0)
            .build();
        FeatureCollection featureCollection = client.elements().nearby(params);
    }
}
Returns Examples