Aller au contenu principal
Query

Requête station

Obtenez les détails d’une station à l’aide de la requête station. Elle est utile lorsque vous souhaitez afficher le type et le nombre de chargeurs, l’emplacement ou tout autre détail actuellement disponible pour une station.

Query

Un id ou un evse_id de station est requis pour obtenir ses détails. L’id peut être obtenu via un itinéraire, le service de tuiles ou la requête station around.

Arguments

id· ID
ID of a station.
evse_id· String
ID of a EVSE.

Champs

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.

Les opérations peuvent échouer. Tenez compte des scénarios d'erreur suivants pour les gérer correctement. Plus sur les erreurs here.

error_forbidden_message
You are forbidden to execute this operation.
invalid_coordinates
Coordinates provided for $LOCATION are not valid.
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.
rate_limit_exceeded
Rate limit exceeded.
station_location_invalid_coordinates
Coordinates provided are not valid.

Ce contenu vous a-t-il été utile ?

Développeurs

Chargetrip ©

Statut inconnu

Gérer les cookies

En vigueur le : 20 mars 2024 · Mis à jour le : 25 janvier 2023

Politique relative aux cookies

Nous utilisons des cookies pour améliorer votre expérience sur developers.chargetrip.com. Cette politique relative aux cookies fait partie de la politique de confidentialité et couvre l’utilisation des cookies entre votre appareil et notre site. Nous fournissons également des informations de base sur les services tiers que nous pouvons utiliser, qui peuvent eux aussi utiliser des cookies dans le cadre de leur service, bien qu’ils ne soient pas couverts par notre politique.

Si vous ne souhaitez accepter aucun cookie de notre part, vous devez configurer votre navigateur pour qu’il refuse les cookies de developers.chargetrip.com, en sachant que nous pourrions alors ne pas être en mesure de vous fournir certains des contenus et services souhaités.

Vérifier vos choix de consentement aux cookies

Un cookie est une petite donnée qu’un site web stocke sur votre appareil lors de votre visite. Il contient généralement des informations sur le site lui-même, un identifiant unique permettant au site de reconnaître votre navigateur à votre retour, des données supplémentaires répondant à la finalité du cookie, ainsi que la durée de vie du cookie.

Les cookies sont utilisés pour activer certaines fonctionnalités (par ex. la connexion), pour suivre l’utilisation du site (par ex. les analyses), pour stocker vos paramètres utilisateur (par ex. le fuseau horaire, les préférences de notification) et pour personnaliser votre contenu (par ex. la publicité, la langue).

Les cookies définis par le site web que vous visitez sont généralement appelés « cookies internes » (first-party) et ne suivent en principe que votre activité sur ce site particulier. Les cookies définis par d’autres sites et entreprises (c’est-à-dire des tiers) peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers.

Cookies essentiels

Les cookies définis par le site web que vous visitez sont généralement appelés « cookies internes » (first-party) et ne suivent en principe que votre activité sur ce site particulier. Les cookies définis par d’autres sites et entreprises (c’est-à-dire des tiers) peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers.

Cookies de performance

Les cookies de ciblage / publicitaires sont utilisés pour déterminer quel contenu promotionnel est le plus pertinent et approprié pour vous et vos centres d’intérêt. Les sites web peuvent les utiliser pour diffuser de la publicité ciblée ou pour limiter le nombre de fois où vous voyez une publicité. Cela aide les entreprises à améliorer l’efficacité de leurs campagnes et la qualité du contenu qui vous est présenté. Ces cookies peuvent être définis par le site web que vous visitez (first-party) ou par des services tiers. Les cookies de ciblage / publicitaires définis par des tiers peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers. Nous utilisons des cookies de ciblage / publicitaires sur notre site.

Cookies marketing / publicitaires

Les cookies de ciblage / publicitaires sont utilisés pour déterminer quel contenu promotionnel est le plus pertinent et approprié pour vous et vos centres d’intérêt. Les sites web peuvent les utiliser pour diffuser de la publicité ciblée ou pour limiter le nombre de fois où vous voyez une publicité. Cela aide les entreprises à améliorer l’efficacité de leurs campagnes et la qualité du contenu qui vous est présenté. Ces cookies peuvent être définis par le site web que vous visitez (first-party) ou par des services tiers. Les cookies de ciblage / publicitaires définis par des tiers peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers. Nous utilisons des cookies de ciblage / publicitaires sur notre site.

Engagement envers les tiers

Nous examinons les politiques de confidentialité de tous nos prestataires tiers avant de faire appel à leurs services, afin de nous assurer que leurs pratiques sont conformes aux nôtres. Nous n’inclurons jamais sciemment des services tiers qui compromettent ou violent la vie privée de nos utilisateurs.

Cookie
google-cookie-consent
Description
Stocke vos préférences en matière de cookies, c’est-à-dire les catégories que vous avez acceptées ou refusées, afin que nous puissions respecter votre choix à chaque visite et ne charger que les outils d’analyse ou de marketing que vous avez autorisés.
Durée de vie
2 ans

Comment contrôler ou refuser les cookies

Si vous ne souhaitez pas accepter les cookies de notre part, vous pouvez configurer votre navigateur pour qu’il refuse les cookies de notre site web. La plupart des navigateurs sont configurés par défaut pour accepter les cookies, mais vous pouvez modifier ces paramètres pour refuser complètement les cookies ou pour être averti lorsqu’un site web tente d’en définir un.

Si vous naviguez sur des sites web depuis plusieurs appareils, vous devrez peut-être modifier vos paramètres sur chacun d’eux.

Bien que certains cookies puissent être bloqués sans grand impact sur l’expérience d’un site web, bloquer tous les cookies peut vous empêcher d’accéder à certaines fonctionnalités et à certains contenus sur les sites que vous visitez.

Nous pouvons mettre à jour cette politique relative aux cookies de temps à autre afin de refléter, par exemple, des changements dans les cookies que nous utilisons ou pour d’autres raisons opérationnelles, juridiques ou réglementaires. Veuillez consulter à nouveau cette politique pour rester informé de notre utilisation des cookies et des technologies associées. La date en haut de cette politique relative aux cookies indique la dernière fois qu’elle a été mise à jour.