Riferimento rapido per l'API Directions

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

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 stato ZERO_RESULTS. Correzione: utilizza i waypoint di sosta (senza prefisso via:), 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_road o heading vengono 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 ometti optimize:true, departure_time (per la guida), side_of_road e heading per rimanere nello SKU Essentials. Consulta /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku.
  • Problema: per la guida, departure_time non può essere nel passato (la richiesta non va a buon fine con INVALID_REQUEST). Senza departure_time, il percorso e la durata utilizzano il traffico medio indipendente dal tempo e non viene restituito duration_in_traffic. Correzione: imposta departure_time su now o su una data futura con mode=driving per ottenere duration_in_traffic. Le richieste che restituiscono duration_in_traffic vengono fatturate in base allo SKU Directions Advanced (Pro). Consulta /maps/documentation/directions/get-directions.