Errori
In caso di errore, verrà restituito un corpo della risposta di errore del formato standard e il codice di stato HTTP verrà impostato su uno stato di errore.
La risposta contiene un oggetto con un singolo oggetto error
con quanto segue
chiavi:
code
: corrisponde allo stato HTTP della risposta.message
: una breve descrizione dell'errore.status
: un codice di stato che indica la natura dell'errore.
Ad esempio, l'invio di un parametro placeId
non valido restituirà quanto segue
errore:
{ "error": { "code": 400, "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"", "status": "INVALID_ARGUMENT" } }
I possibili errori includono:
Codice | Stato | Messaggio | Risoluzione dei problemi |
---|---|---|---|
400 | INVALID_ARGUMENT |
La chiave fornita non è valida. | La tua chiave API non è valida o non è stata inclusa nella richiesta. Assicurati di aver incluso l'intera chiave e di avere abilitato l'API per questa chiave. |
400 | INVALID_ARGUMENT |
"\"percorso\" parametro contiene un valore non valido: ☃" | La tua richiesta contiene argomenti non validi. Le cause più probabili
sono:
Questo errore non verrà restituito se viene passato un |
403 | PERMISSION_DENIED |
La richiesta non registrata è stata bloccata. Registrati utilizzando Google Developers Google Cloud. | La richiesta è stata rifiutata per uno o più dei seguenti motivi:
Per utilizzare i prodotti Google Maps Platform, la fatturazione deve essere attivata su il tuo account e tutte le richieste devono includere una chiave API valida. Per risolvere il problema, procedi nel seguente modo:
|
404 | NOT_FOUND |
Per questo servizio è richiesto HTTPS. | Assicurati di inviare richieste a
https://roads.googleapis.com/ e non
http://roads.googleapis.com/ . |
429 | RESOURCE_EXHAUSTED |
La richiesta è stata limitata perché sono stati raggiunti i limiti per le richieste di progetto. | Hai superato il limite di richieste che hai configurato in nella console Google Cloud. Questo limite viene in genere impostato come richieste al giorno, richieste per 100 secondi e richieste per 100 secondi per utente. Questo limite deve essere configurato per evitare che un singolo o un piccolo gruppo di di esaurire la quota giornaliera, pur consentendo un importo ragionevole per tutti gli utenti. Consulta Limitazione dell'utilizzo delle API per configurare questi limiti. |
Backoff esponenziale
Quando le richieste non vanno a buon fine, assicurati di riprovare con regole esponenziali il backoff. Ad esempio, se una richiesta non va a buon fine una volta, riprova dopo un secondo, se non riesce di nuovo, riprova dopo due secondi, poi quattro secondi e così via. Questo assicura che le richieste inaccessibili o gli errori su larga scala non indaghino le poiché molti client provano a ritentare le richieste molto rapidamente.
Domande frequenti sulla risoluzione dei problemi
Problemi di implementazione
- Con quale frequenza devo campionare la posizione del mio veicolo?
- Ogni 1-10 secondi è consigliato per risultati di alta qualità da agganciare alla strada.
- Esiste un limite al numero di punti che posso inviare per ogni query?
- Sì, una query può avere al massimo 100 punti.
- Quale livello di precisione devo utilizzare per memorizzare la latitudine/longitudine agganciata coppie?
- Per garantire che i percorsi agganciati seguano le strade a tutti i livelli di zoom, anche alla livello di zoom massimo, devi memorizzare le coppie latitudine/longitudine agganciate a 7 posizioni decimali di precisione.
- Posso utilizzare le polilinee codificate per visualizzare i percorsi agganciati?
- Le polilinee codificate vengono specificate solo con una precisione di cinque cifre decimali, il che genera un errore di circa 2 metri. Le polilinee codificate sono quindi non adatta se vuoi che i percorsi agganciati seguano la strada con zoom elevato diversi.
Problemi comuni
- Alcuni punti non vengono agganciati oppure sono presenti intervalli vuoti nei percorsi agganciati. Come puoi Correggo?
-
- Se effettui il campionamento dei punti a intervalli prestabiliti, assicurati che i punti siano campionato a intervalli più brevi (ogni 1-10 secondi). Se viene utilizzato un intervallo più lungo (ad es. 60 secondi), l'algoritmo Snap-to-Road potrebbe non essere in grado determinare le strade percorse con sufficiente precisione.
- Se fai clic manualmente su una mappa per creare punti, è molto facile creano percorsi con pochi punti o punti sparsi che l'algoritmo di aggancio non li gestisce bene. L'algoritmo di aggancio funziona al meglio per i punti che molto vicini. Prova la funzione Allinea a Demo sulle strade oppure usa le strade inspector per testare i percorsi.
- Perché i miei percorsi agganciati sono frastagliati o leggermente distanti dalla strada quando aumentare lo zoom?
-
- Stai troncando la precisione delle coppie latitudine/longitudine agganciate prima di mostrarli? Memorizzazione delle coppie latitudine/longitudine agganciate in un precisione inferiore a sette cifre decimali causa errori di precisione quando il percorso agganciato viene visualizzato sulla mappa.
- Utilizzi polilinee codificate? Polilinee codificate troncate le coppie latitudine/longitudine a cinque cifre decimali, il che introduce un errore di diversi metri, con conseguenti linee frastagliate o leggermente lontane dalla strada a livelli di zoom elevati.
Se nessuna delle opzioni precedenti è il caso, i riquadri della mappa potrebbero essere stati aggiornati di recente, causandone la mancata sincronizzazione con l'indice della strada usato agganciare. Se sono interessate solo alcune delle tue query, è probabile che questa sia la causa. Poiché Google Maps viene aggiornato regolarmente, questo può accadere di tanto in tanto, e possono verificarsi più spesso se osservi regolarmente i vecchi percorsi su una mappa (ad ad esempio i percorsi acquisiti diverse settimane fa). Per una visualizzazione ottimale, è necessario creare di nuovo i vecchi percorsi poco prima di mostrarli sulla mappa, in modo da ridurre al minimo le incongruenze tra i riquadri della mappa e l'indice della strada utilizzato agganciare.
- Perché il limite di velocità della strada X potrebbe non essere visualizzato correttamente?
- I limiti di velocità provengono da diverse fonti che variano per precisione e copertura.
Se trovi uno schema, ad esempio limiti di velocità per un determinato tipo di strada oppure
in una particolare area sono costantemente sbagliati, procedi nel seguente modo
per comunicarci:
- Apri Google Maps sul computer OPPURE sul tuo computer Android.
- Apri il menu laterale a sinistra.
- Seleziona Invia feedback. Nota: è possibile che ti venga richiesto di accedere.
- Seleziona Modifica la mappa.
- Seleziona il tratto di strada da modificare.
- Seleziona Avanti.
- Nella sezione "Altro" , indica che il limite di velocità della strada non è corretto.
- Seleziona Invia.
- Perché il mio percorso agganciato taglia angoli invece di seguire la strada?
-
Per risolvere il problema, verifica quanto segue:
- Assicurati che il parametro
interpolate
sia impostato sutrue
. - Verificare che i punti di dati originali siano campionati a intervalli sufficientemente vicini (ogni 1-10 secondi).
- Assicurati che il parametro
- Perché vengono restituiti molti tratti di strada nel percorso agganciato per una strada senza modifiche ai limiti di velocità?
- Quando il parametro
interpolate
è impostato sutrue
, la query di posizionamento alla strada restituisce una polilinea che segue la strada intorno agli angoli, curve e rotonde. Se la strada si curva, vengono visualizzati più tratti di strada anche se il limite di velocità non cambia, per creare una polilinea che segue da vicino la geometria della strada.