Risoluzione dei problemi

Errori

In caso di errore, verrà restituito un corpo della risposta di errore in 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 le seguenti chiavi:

• code: è uguale 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à il seguente errore:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

I possibili errori includono:

Backoff esponenziale

Quando le richieste non vanno a buon fine, devi assicurarti di riprovare con backoff esponenziale. Ad esempio, se una richiesta non riesce una volta, riprova dopo un secondo, se non riesce di nuovo, riprova dopo due secondi, poi quattro secondi e così via. In questo modo, le richieste interrotte o gli errori su larga scala non sovraccaricano i server di Google, poiché molti client tentano di ripetere le richieste molto rapidamente.

Domande frequenti sulla risoluzione dei problemi

Problemi di implementazione

Con quale frequenza devo campionare la posizione del mio veicolo?

È consigliabile un intervallo di 1-10 secondi per ottenere risultati di snap-to-road di alta qualità.

Esiste un limite al numero di punti che posso inviare per query?

Sì, una query può avere al massimo 100 punti.

Quale livello di precisione devo utilizzare per memorizzare le coppie di latitudine/longitudine istantanee?

Per assicurarti che i percorsi agganciati seguano le strade a tutti i livelli di zoom, anche al livello di zoom massimo, devi memorizzare le coppie di latitudine/longitudine agganciate con una precisione di 7 cifre decimali.

Posso utilizzare polilinee codificate per visualizzare i percorsi agganciati?

Le polilinee codificate vengono specificate solo con una precisione di 5 cifre decimali, il che comporta un errore di circa 2 metri. Pertanto, le polilinee codificate non sono adatte se vuoi che i percorsi agganciati seguano la strada a livelli di zoom elevati.

Problemi comuni

Alcuni punti non vengono agganciati o ci sono spazi vuoti nei percorsi agganciati. Come posso correggere questo errore?

• Se campioni i punti a intervalli di tempo, assicurati che i punti vengano campionati a intervalli più brevi (ogni 1-10 secondi). Se viene utilizzato un intervallo più lungo (ad esempio 60 secondi), l'algoritmo di posizionamento su strada potrebbe non essere in grado di determinare le strade percorse con sufficiente precisione.
• Se fai clic manualmente su una mappa per creare punti, è molto facile creare percorsi con pochi punti o punti sparsi che l'algoritmo di snapping non gestisce bene. L'algoritmo di snapping funziona meglio per i punti vicini tra loro. Prova la demo di Snap to Roads o utilizza lo strumento di controllo delle strade per testare i tuoi percorsi.

Perché i miei percorsi agganciati sono irregolari o leggermente fuori strada quando ingrandisco?

• Tronchi la precisione delle coppie di latitudine/longitudine agganciate prima di visualizzarle? L'archiviazione di coppie di latitudine/longitudine allineate con una precisione inferiore a 7 cifre decimali causa errori di precisione quando il percorso allineato viene visualizzato sulla mappa.
• Utilizzi polilinee codificate? Le polilinee codificate troncano le coppie di latitudine/longitudine a 5 cifre decimali, il che introduce un errore di diversi metri, con conseguenti linee frastagliate o leggermente fuori strada a livelli di zoom elevati.

Se nessuna delle condizioni precedenti è vera, è possibile che i riquadri della mappa siano stati aggiornati di recente, causando la mancata sincronizzazione con l'indice delle strade utilizzato per lo snapping. Se solo alcune delle tue query sono interessate, è probabile che questa sia la causa. Poiché Google Maps viene aggiornato regolarmente, questo può accadere occasionalmente e può verificarsi più spesso se guardi regolarmente vecchi percorsi su una mappa (ad esempio, percorsi acquisiti diverse settimane fa). Per una visualizzazione ottimale, devi eseguire nuovamente lo snap dei percorsi precedenti appena prima di mostrarli su una mappa, in modo da ridurre al minimo le incoerenze tra i riquadri della mappa e l'indice delle strade utilizzato per lo snap.

Quale potrebbe essere la causa della visualizzazione errata del limite di velocità per la strada X?

I limiti di velocità provengono da diverse fonti che variano in termini di accuratezza e copertura. Se trovi un pattern, ad esempio limiti di velocità per un determinato tipo di strada o in un'area specifica che sono costantemente errati, segui questi passaggi per comunicarcelo:

1. Apri Google Maps sul computer o l'app Google Maps per Android.
2. Apri il menu laterale.
3. Seleziona Invia feedback. Nota: potrebbe esserti chiesto di accedere.
4. Seleziona Modifica la mappa.
5. Seleziona il segmento stradale che vuoi modificare.
6. Seleziona Avanti.
7. Nel campo "Altro", indica che il limite di velocità è errato per quella strada.
8. Seleziona Invia.

Puoi anche segnalare altri problemi qui (ad esempio se la strada ha un nome errato, è disegnata in modo errato, è chiusa o è privata).

Perché il percorso agganciato taglia le curve anziché seguire la strada?

Per risolvere il problema, verifica quanto segue:

• Assicurati che il parametro interpolate sia impostato su true.
• Verifica che i punti dati originali vengano campionati a intervalli sufficientemente ravvicinati (ogni 1-10 secondi).

Perché ricevo molti segmenti stradali nel percorso agganciato per una strada senza variazioni del limite di velocità?

Quando il parametro interpolate è impostato su true, la query di posizionamento su strada restituisce una polilinea che segue la strada in corrispondenza di angoli, curve e rotatorie. Se la strada è curva, vengono restituiti più segmenti stradali anche se il limite di velocità non cambia, in modo da creare una polilinea che segua fedelmente la geometria della strada.