Vai al contenuto principale

Sviluppatori

Dashboard
Dashboard
Query

Stazioni nelle vicinanze

Con la query stationAround puoi recuperare le stazioni entro un raggio specifico da un punto GeoJSON. Può essere utile quando una stazione è occupata o quando vuoi offrire diverse opzioni di ricarica.

Query

Per cercare le stazioni intorno a un punto sono necessari una location (punto GeoJSON) e una distance in metri. Usa gli argomenti filter e search per restringere i risultati e gli argomenti size e page per paginarli.

Argomenti

query· StationAroundQuery
Query parameters to filter stations.
filter· StationAroundFilter
Criteria to filter stations.
size· Int
Number of elements (count) to return.
page· Int
Page number to return.

Campi

id· ID
Unique ID of a station. This property is OCPI-compliant.
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.
OCPIParkingType enum values
ALONG_MOTORWAY

Location on a parking facility/rest area along a motorway, freeway, interstate, highway etc.

PARKING_GARAGE

Multistorey car park.

PARKING_LOT

A cleared area that is intended for parking vehicles, i.e. at supermarkets, bars, etc.

ON_DRIVEWAY

Location is on the driveway of a house/building.

ON_STREET

Parking in public space along a street.

UNDERGROUND_GARAGE

Multistorey car park, mainly underground.

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.
OCPIFacility enum values
HOTEL

A hotel.

RESTAURANT

A restaurant.

CAFE

A cafe.

MALL

A mall or shopping center.

SUPERMARKET

A supermarket.

SPORT

Sport facilities: gym, field etc.

RECREATION_AREA

A recreation area.

NATURE

Located in, or close to, a park, nature reserve etc.

MUSEUM

A museum.

BIKE_SHARING

A bike/e-bike/e-scooter sharing location.

BUS_STOP

A bus stop.

TAXI_STAND

A taxi stand.

TRAM_STOP

A tram stop/station.

METRO_STATION

A metro station.

TRAIN_STATION

A train station.

AIRPORT

An airport.

PARKING_LOT

A parking lot.

CARPOOL_PARKING

A carpool parking.

FUEL_STATION

A Fuel station.

WIFI

Wifi or other type of internet available.

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 was 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.
amenities· JSON
Amenities located at this location.
physical_address· Address
Enriched information about the physical address of a station.
heavy_vehicles_properties· StationHeavyVehiclesProperties
Describes the heavy vehicle properties at the location.
heavy_vehicles_restrictions· StationHeavyVehiclesRestrictions
Describes the heavy vehicle restrictions at the location.
vehicle_restrictions· StationVehicleRestrictions
Describes the vehicle restrictions at the location.
location_category· String
Type of location where the charge point is located. For example: "shop".
entrance_for_navigation· OCPIAdditionalGeoLocation
Coordinates for the location's entrances in decimal degrees. If available, there can be more than one entrance to the location.
properties· JSON· No longer used.
Optional object where you can store custom data you need in your application. This extends the current functionalities we offer.
realtime· Boolean
A flag that indicates if a station has real-time information about the availability of its connectors.
power· JSON
Connectors grouped by power.
predicted_occupancy· StationPredictedOccupancy
Predicted station occupancy.
speed· StationSpeedType
Charging speed for a station.
StationSpeedType enum values
slow

Slow charging (below 43 kW).

fast

Fast charging stations (above 43 kW and below 150 kW).

turbo

Ultra fast charging stations (above 150 kW).

status· ChargerStatus
Global status for a station.
ChargerStatus enum values
free

The charger is free.

busy

The charger is occupied/busy.

unknown

The charger is unknown.

error

The charger has an error.

custom_properties· StationCustomProperties
Custom properties of a station. These are vendor specific and will return null values on the fields that are not supported by your station database.
review· ReviewStats
Review of a station.
roaming· StationRoaming
List of eMSP cards accepted at a charging station.
support_phone_number· String
Phone number for assistance at a charging station.
charging_behaviour· ChargingBehaviour
Charging behavior of a station.
reliability_score· Int
Shows how reliable a charging station is (1 to 5; 1 = unreliable, 5 = reliable), taking into account the charging behaviour history and error values.
adhoc_authorisation_payment_method· StationAdhocAuthorisationPaymentMethod
Indicates the authentication and payment methods.
StationAdhocAuthorisationPaymentMethod enum values
AUTH_BY_CAR_PLUG_AND_CHARGE

Authentication by car through Plug and Charge.

ONLINE_APPLE_PAY

Apple Pay.

TERMINAL_IN_APP

Terminal in-app.

ONLINE_PAYPAL

PayPal.

SERVICE_PROVIDER_RFID_CARD

Service Provider RFID Card.

TERMINAL_QR_CODE

Terminal QR Code.

TERMINAL_CREDIT_CARD

Terminal Credit Card.

TERMINAL_DEBIT_CARD

Terminal Debit Card.

TERMINAL_SMS

Terminal SMS.

ONLINE_CREDIT_CARD

Credit Card.

OTHER_OTHER

Other.

TERMINAL_CONTACTLESS

Terminal Contactless.

ONLINE_GOOGLE_PAY

Google Pay.

ONLINE_BANK_PAYMENT

Bank Payment.

AUTH_BY_CAR_AUTOCHARGE

Authentication by car through Auto Charge.

access_type· AccessType
Type of access to the charging station.
AccessType enum values
Public

Restricted

Private

boosting_group_ids· ID· beta
List of active boosting groups to which the station belongs.

Errori

Le operazioni possono non riuscire. Tieni conto dei seguenti scenari di errore per gestirli correttamente. Ulteriori informazioni sugli errori here.

error_forbidden_message
You are forbidden to execute this operation.
missing_required_parameters
Missing required parameter(s): $PARAMETERS.
operation_not_allowed
You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
pagination_invalid_page
Page must be an INT value higher than 0.
pagination_invalid_size
Size must be an INT value between 1 and 1000.
rate_limit_exceeded
Rate limit exceeded.
station_distance_above_allowed
The provided distance is too big. The value must be less than or equal to 10.000 meters.
station_distance_below_allowed
The provided distance is too small. The value must be greater than 0.
station_power_below_allowed
The provided power is too small. The value must be greater than 0 kwh.

Questo contenuto ti è stato utile?

Crea

Sviluppatori

Aggiornamenti

Risorse

Legale

Contattaci

Chargetrip ©

Stato sconosciuto

Gestisci i cookie

In vigore dal: 20 marzo 2024 · Aggiornato il: 25 gennaio 2023

Utilizziamo i cookie per migliorare la tua esperienza su developers.chargetrip.com. Questa politica sui cookie fa parte dell’informativa sulla privacy e riguarda l’uso dei cookie tra il tuo dispositivo e il nostro sito. Forniamo inoltre informazioni di base sui servizi di terze parti che potremmo utilizzare, i quali possono a loro volta usare cookie come parte del loro servizio, anche se non sono coperti dalla nostra politica.

Se non desideri accettare alcun cookie da parte nostra, devi impostare il tuo browser in modo da rifiutare i cookie provenienti da developers.chargetrip.com, tenendo presente che potremmo non essere in grado di offrirti alcuni dei contenuti e dei servizi desiderati.

Un cookie è un piccolo frammento di dati che un sito web memorizza sul tuo dispositivo quando lo visiti. In genere contiene informazioni sul sito stesso, un identificatore univoco che consente al sito di riconoscere il tuo browser quando torni, dati aggiuntivi che servono allo scopo del cookie e la durata del cookie stesso.

I cookie vengono utilizzati per abilitare determinate funzioni (ad es. l’accesso), per monitorare l’utilizzo del sito (ad es. analisi), per memorizzare le tue impostazioni utente (ad es. fuso orario, preferenze di notifica) e per personalizzare i tuoi contenuti (ad es. pubblicità, lingua).

I cookie impostati dal sito web che stai visitando sono normalmente chiamati “cookie di prima parte” e in genere tracciano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ovvero terze parti) possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti.

I cookie impostati dal sito web che stai visitando sono normalmente chiamati “cookie di prima parte” e in genere tracciano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ovvero terze parti) possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti.

I cookie di targeting / pubblicitari vengono utilizzati per determinare quali contenuti promozionali sono più rilevanti e appropriati per te e i tuoi interessi. I siti web possono usarli per mostrare pubblicità mirata o per limitare il numero di volte in cui visualizzi un annuncio. Questo aiuta le aziende a migliorare l’efficacia delle loro campagne e la qualità dei contenuti che ti vengono presentati. Questi cookie possono essere impostati dal sito web che stai visitando (prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti. Utilizziamo cookie di targeting/pubblicitari sul nostro sito.

Cookie di marketing / pubblicitari

I cookie di targeting / pubblicitari vengono utilizzati per determinare quali contenuti promozionali sono più rilevanti e appropriati per te e i tuoi interessi. I siti web possono usarli per mostrare pubblicità mirata o per limitare il numero di volte in cui visualizzi un annuncio. Questo aiuta le aziende a migliorare l’efficacia delle loro campagne e la qualità dei contenuti che ti vengono presentati. Questi cookie possono essere impostati dal sito web che stai visitando (prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti. Utilizziamo cookie di targeting/pubblicitari sul nostro sito.

Impegno verso le terze parti

Esaminiamo le informative sulla privacy di tutti i nostri fornitori terzi prima di avvalerci dei loro servizi, per assicurarci che le loro pratiche siano in linea con le nostre. Non includeremo mai consapevolmente servizi di terze parti che compromettano o violino la privacy dei nostri utenti.

Cookie
google-cookie-consent
Descrizione
Memorizza le tue preferenze sui cookie, ovvero quali categorie hai accettato o rifiutato, in modo da rispettare la tua scelta a ogni visita e caricare solo gli strumenti di analisi o di marketing che hai autorizzato.
Durata
2 anni

Se non desideri accettare i cookie da parte nostra, puoi impostare il tuo browser in modo da rifiutare i cookie del nostro sito web. La maggior parte dei browser è configurata per accettare i cookie per impostazione predefinita, ma puoi modificare queste impostazioni per rifiutare del tutto i cookie oppure per ricevere una notifica quando un sito web tenta di impostarne uno.

Se navighi su siti web da più dispositivi, potresti dover aggiornare le impostazioni su ciascun dispositivo.

Anche se alcuni cookie possono essere bloccati con un impatto minimo sull’esperienza di un sito web, bloccare tutti i cookie potrebbe impedirti di accedere ad alcune funzioni e contenuti dei siti che visiti.

Potremmo aggiornare questa Politica sui cookie di tanto in tanto, ad esempio per riflettere modifiche ai cookie che utilizziamo o per altri motivi operativi, legali o normativi. Ti invitiamo a rivisitare questa Politica sui cookie per rimanere informato sul nostro uso dei cookie e delle tecnologie correlate. La data in alto in questa Politica sui cookie indica quando è stata aggiornata l’ultima volta.