Documentazione API

Integra nella tua piattaforma le potenti capacità di routing e pianificazione EV di ABRP. La nostra suite di API consente un’integrazione fluida di routing consapevole del veicolo, telemetria e deep link.

API e integrazione

Accedi alla nostra suite di API per integrare routing EV, telemetria e deep link nella tua piattaforma.

Planning API

v2 - Consigliata

v1 - Legacy

Routing consapevole del veicolo con pianificazione EV completa

La Planning API offre pianificazione di percorsi sofisticata che evolve con i continui miglioramenti di ABRP: modellazione dei consumi energetici, ottimizzazione delle ricariche, integrazione del traffico in tempo reale e pianificazione che tiene conto del meteo.

L’API usa un’architettura REST con output JSON e supporta endpoint legacy (v1) e moderni (v2). I costi di setup e i prezzi per piano variano in base alle esigenze di integrazione e al volume d’uso.

Documentazione Planning v2 Documentazione Planning v1 (Legacy)

Telemetry API

Dati veicolo in tempo reale per tracciamento e modellazione

La Telemetry API consente la trasmissione in tempo reale dei dati del veicolo per seguire i viaggi in diretta, analizzare i consumi e migliorare continuamente i nostri modelli. Così affiniamo le previsioni energetiche e la precisione del routing.

Sono disponibili chiavi API gratuite. Per inviare dati servono token utente, ottenibili tramite il flusso OAuth2 (consigliato) o manualmente per test e sviluppo.

Documentazione Telemetry Gestisci le tue chiavi API Telemetry

OAuth2 API

Autenticazione e autorizzazione utenti sicure

OAuth2 offre un modo sicuro e comodo per identificare e autenticare gli utenti con Iternio. Per configurarlo ti servono una chiave API, un URL di reindirizzamento e il nome dell’applicazione.

Flusso di autorizzazione

La prima chiamata restituisce una pagina HTML in cui l’utente effettua l’accesso e approva la tua applicazione. Se aperta nel browser predefinito, l’accesso può restare in cache per semplificare il processo.

https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>

Scope consentiti:

get_telemetry: Recupera l’ultima telemetria dell’utente
set_telemetry: Invia nuovi aggiornamenti di telemetria al veicolo
get_plan: Ottieni l’ultimo piano in forma compatta (contattaci per i dettagli)
vehicle_history: Recupera tragitti e sessioni di ricarica storiche (contattaci per i dettagli)

Risposta sul tuo URI di redirect:

https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>

Recupero del token

Dopo aver ricevuto un codice di autorizzazione, recupera il token da poter salvare e riutilizzare.

https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>

Formato della risposta:

{
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}

Informazioni utente

Ottenuto il token, usa l’endpoint "me" per recuperare le informazioni utente:

https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>

Formato della risposta:

{
  "user_id": <the numeric ID of the user>,
  "full_name": "<Full name of the user>",
  "email": "<Email of user>",
  "vehicle_id": <The numeric ID of the vehicle, if part of the scope>,
  "vehicle_name": "<The vehicle name>",
  "vehicle_typecode": "<The vehicle typecode>"
}

Deep link

Integrazione tramite URL per pianificazione preconfigurata

Crea URL personalizzate che avviano ABRP con percorsi, selezioni veicolo e parametri di pianificazione preimpostati. Perfetto da incorporare in app, siti o sistemi di navigazione senza integrazione API.

I deep link supportano molti parametri URL tra cui coordinate di origine e destinazione, waypoint, modelli auto, stato di carica e preferenze utente. URL base: https://abetterrouteplanner.com

Documentazione deep link