Query stations around a GeoJSON point

With the query stationsAround you can fetch the stations around a GeoJSON point with a specific distance in meters. This can be useful when a station is busy, or when you want to provide several charging options.

Query stations around

Fetch the 20 closest stations around a GeoJSON location and plot them on a map.

Query stations around

Query

Query stations around a certain location by passing some coordinates into the stationAround query. Optionally add some filters or maintain performance by including pagination.

Filters

When querying a station around a GeoJSON location you need to set the location and distance on the filter argument. Optionally you can set power and amenities.

Pagination

To limit your results and improve the performance you can use pagination on your query.

Arguments

query StationAroundQuery

Deprecated

Deprecated: Replaced by filter and search params.

filter StationAroundFilter

Filter station around result.

size Int

Number of elements (count) to return.

Default • 10

page Int

Page number to return.

Default • 0

Frequently used fields

id ID

Unique ID of a station. This property is OCPI-compliant.

Other fields

country_code String

ISO-3166 alpha-2 country code of a station. This property is OCPI-compliant.

party_id String

CPO ID of a CPO that 'owns' this station (following the ISO-15118 standard). This property is OCPI-compliant.

publish Boolean

Defines if a location may be published on a website or app etc. When this is set to false, only tokens identified in the field: publish_allowed_to are allowed to show this location. When the same location has EVSEs that may be published and may not be published, two 'locations' should be created. This property is OCPI-compliant.

name String

Name of a charging station. This property is OCPI-compliant.

address String

Street/block name and house number if available. This property is OCPI-compliant.

city String

City or town. This property is OCPI-compliant.

postal_code String

Postal code of a location, may only be omitted when a location has no postal code: in some countries charging locations at highways don’t have postal codes. This property is OCPI-compliant.

state String

State or province of a location, only to be used when relevant. This property is OCPI-compliant.

country String

ISO 3166-1 alpha-3 code for the country of this station. This property is OCPI-compliant.

coordinates OCPIGeoLocation

Coordinates of a location. This property is OCPI-compliant.

parking_type OCPIParkingType

Type of parking at a charge point location. This property is OCPI-compliant.

Show OCPIParkingType enum values

evses EVSE

EVSEs that belong to a station. This property is OCPI-compliant.

directions OCPIDisplayText

Human-readable directions on how to reach a station. This property is OCPI-compliant.

operator Operator

Information about an operator. This property is OCPI-compliant.

suboperator Operator

Information about a suboperator if applicable. This property is OCPI-compliant.

owner Operator

Information about an owner if available. This property is OCPI-compliant.

facilities OCPIFacility

Facilities a charging station belongs to. This property is OCPI-compliant.

Show OCPIFacility enum values

time_zone String

Value from the IANA time zone database representing the time zone of a location. Examples: "Europe/Oslo", "Europe/Zurich". (http://www.iana.org/time-zones). This property is OCPI-compliant.

opening_times OCPIHours

Times when an EVSEs at a location can be accessed for charging. This property is OCPI-compliant.

charging_when_closed Boolean

Indicates if the EVSEs are still charging outside the opening hours. E.g. when a parking garage closes its barriers overnight, is it allowed to charge till the next morning? Default: true. This property is OCPI-compliant.

images OCPIImage

Links to images related to a location such as photos or logos. This property is OCPI-compliant.

energy_mix OCPIEnergyMix

Details of the energy supplied at a location. This property is OCPI-compliant.

last_updated DateTime

Timestamp when a location, or one of its EVSEs or Connectors were last updated (or created). This property is OCPI-compliant.

external_id String

ID provided by a station data source.

location Point

GeoJSON location of a charging station.

elevation Int

Elevation (altitude) level.

chargers Charger

Groups of EVSEs by power and type.