Riquadri della roadmap

Panoramica del riquadro della roadmapI riquadri della mappa stradale sono riquadri di immagini basati su dati topografici vettoriali con lo stile cartografico di Google. Sono inclusi strade, edifici, punti d'interesse e confini politici.

Recupero dei riquadri della roadmap

Puoi iniziare a effettuare richieste di riquadri della roadmap dopo aver ricevuto un token di sessione. Poiché il token di sessione si applica all'intera sessione, non è necessario specificare le opzioni di mappa nelle richieste di riquadri.

Il seguente esempio di codice mostra una tipica richiesta di token di sessione per i riquadri di una roadmap.

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Puoi ottenere riquadri della roadmap effettuando una richiesta HTTPS GET, come mostrato nell'esempio seguente.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

In questa richiesta GET HTTPS, z è il livello di zoom (compreso tra 0 e 22), mentre x e y sono le coordinate del riquadro del riquadro che vuoi recuperare.

Il parametro orientation è facoltativo. Il suo valore specifica il numero di gradi di rotazione in senso antiorario dell'immagine riquadro. orientation è supportato per i riquadri roadmap ed è supportato anche per richieste relative a satellite e rilievo con immagini di base rimosse utilizzando "overlay": true e con layerTypes impostato. I valori orientation validi sono 0 (valore predefinito), 90, 180 e 270.

La griglia delle coordinate dei riquadri non viene ruotata se includi un valore orientation. Ad esempio, se imposti orientation su 90, la coordinata x definisce comunque la posizione da sinistra a destra del riquadro, che in questo caso è da nord a sud sulla mappa.

Orientamento a zero gradi Orientamento a 90 gradi
Orientamento a zero gradi Orientamento a 90 gradi

Esempio di richiesta di riquadro

Considera l'esempio seguente, che richiede un singolo riquadro che contiene il mondo intero. In questo esempio, il livello di zoom è 0, mentre le coordinate X e Y sono 0, 0.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

In questo esempio non è presente alcun messaggio di risposta dal server. Al contrario, il riquadro viene scaricato in un file locale, con le seguenti statistiche.

Il mondo intero in un unico riquadro

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

Per informazioni sulle intestazioni dei messaggi di risposta, consulta Pre-recupero, memorizzazione nella cache o archiviazione dei contenuti.