Skip to content
Plaza Plaza Docs
GuidesPlaygroundDashboard
API Reference
Elements

Find features near a geographic point

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

Find features near a geographic point

ParametersExpand Collapse
params: ElementNearbyParams
lat: Double

Latitude (-90 to 90)

lng: Double

Longitude (-180 to 180)

limit: Optional<Long>

Maximum results (default 20, max 100)

radius: Optional<Long>

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).

features: List<GeoJsonFeature>
geometry: GeoJsonGeometry
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
id: Optional<String>

Feature identifier (type/osm_id)

osmId: Optional<Long>

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

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

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