Le tessere della roadmap sono tessere immagine basate su dati topografici vettoriali
con lo stile cartografico di Google. Sono inclusi strade, edifici, punti
d'interesse e confini politici.
Ottenere le schede 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 devi specificare le opzioni della mappa con le richieste di riquadri.
Il seguente esempio di codice mostra una tipica richiesta di token di sessione per i riquadri della 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"
Per ottenere i riquadri della mappa stradale, devi effettuare 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 del riquadro. orientation è
supportato per i riquadri roadmap, nonché per le richieste satellitari e
del terreno con le immagini di base rimosse utilizzando "overlay": true e con
layerTypes impostato. I valori validi di orientation sono 0 (il valore predefinito), 90, 180 e
270.
La griglia delle coordinate del riquadro non viene ruotata se includi un valore orientation. Ad esempio, se imposti orientation su 90, la coordinata x definisce comunque la posizione della tessera da sinistra a destra, che in questo caso va da nord a sud sulla mappa.
| Orientamento a zero gradi | Orientamento a 90 gradi |
|---|---|
 |
 |
Esempio di richiesta di riquadro
Considera l'esempio seguente, che richiede un'unica tessera contenente il mondo intero. In questo esempio, il livello di zoom è 0 e 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. Il riquadro viene scaricato in un file locale con le seguenti statistiche.
% 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, vedi Pre-fetching, memorizzazione nella cache o archiviazione dei contenuti.