L'API Directions (Legacy) è un servizio web che calcola le indicazioni stradali tra località per la guida, a piedi, in bicicletta e con il trasporto pubblico, inclusi i percorsi in più parti con waypoint, e restituisce percorsi, tappe e passaggi in formato JSON o XML. È in stato Legacy: a partire da ottobre 2026 non può essere abilitata per i nuovi progetti Google Cloud; esegui la migrazione all'API Routes.
API Directions: informazioni chiave
- Prodotto: API Directions
- Nota anche come: API Directions (legacy)
- Categoria: Percorsi
- Piattaforma: servizio web (REST)
- Esecuzione su: server (codice di backend)
- Fase di lancio: GA
- Ciclo di vita: legacy
- Sostituita da: API Routes
- Panoramica: Panoramica dell'API Directions
- Disponibilità regionale: ovunque. La copertura varia in base alla regione e alla modalità di viaggio (il trasporto pubblico dipende dai dati dei fornitori di servizi di trasporto pubblico). (dettagli sulla copertura)
API Directions: quando utilizzarla
Utilizza l'API Directions quando:
- Gestisci un progetto Google Cloud esistente in cui è già abilitata l'API Directions (Legacy) e che chiama
maps/api/directions. - Hai bisogno di indicazioni stradali lato server per la guida, a piedi, in bicicletta o con il trasporto pubblico (waypoint solo per le modalità non di trasporto pubblico), in JSON o XML, in un progetto esistente.
Non utilizzare l'API Directions quando:
- Stai avviando un nuovo progetto Google Cloud. A partire da ottobre 2026, l'API Directions (legacy) non potrà essere abilitata per i nuovi progetti. Utilizza invece l'API Routes.
- Hai bisogno di nuove funzionalità di routing e di prestazioni migliorate. Utilizza invece l'API Routes.
- Hai bisogno di tempi di percorrenza e distanze per molte origini e destinazioni in un'unica richiesta. Utilizza invece l'API Routes.
API Directions: configurazione
- Servizio da attivare:
directions-backend.googleapis.com - Autenticazione: chiave API
- Inizia: configura l'API Directions
- Riferimento: Riferimento API Directions
- Prezzi: Utilizzo e fatturazione dell'API Directions
- Norme: Norme relative all'API Directions
- Note di rilascio: note di rilascio dell'API Directions
API Directions: errori comuni
- Problema: le richieste all'API Directions (legacy) da un progetto in cui l'API legacy non è abilitata non vanno a buon fine con
LegacyApiNotActivatedMapError. Correzione: se l'app è tua, esegui la migrazione all'API Routes. Come soluzione a breve termine durante la migrazione o in attesa di un aggiornamento dell'app, puoi attivare l'API precedente compilando il modulo di attivazione dell'API precedente. Consulta /maps/legacy. - Problema: l'utilizzo del prefisso
via:sui waypoint li rende punti di passaggio obbligatori, il che può causare deviazioni significative o uno statoZERO_RESULTS. Correzione: utilizza i waypoint di sosta (senza prefissovia:), a meno che non sia richiesto un punto di passaggio rigoroso. Consulta /maps/documentation/directions/get-directions. - Problema: le richieste con 11-25 waypoint,
optimize:true, durate sensibili al traffico (duration_in_traffic) o i modificatori di localitàside_of_roadoheadingvengono fatturate con lo SKU Directions Advanced (Pro) più elevato. Correzione: utilizza queste funzionalità solo quando ne hai bisogno; mantieni i waypoint a un massimo di 10 e omettioptimize:true,departure_time(per la guida),side_of_roadeheadingper rimanere nello SKU Essentials. Consulta /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Problema: per la guida,
departure_timenon può essere nel passato (la richiesta non va a buon fine conINVALID_REQUEST). Senzadeparture_time, il percorso e la durata utilizzano il traffico medio indipendente dal tempo e non viene restituitoduration_in_traffic. Correzione: impostadeparture_timesunowo su una data futura conmode=drivingper ottenereduration_in_traffic. Le richieste che restituisconoduration_in_trafficvengono fatturate in base allo SKU Directions Advanced (Pro). Consulta /maps/documentation/directions/get-directions.