Un token di sessione è un dato (un
UUID)
che viene utilizzato nelle chiamate REST per identificare
sessione: una
di scambi di messaggi correlati. Devi includere un token di sessione in tutte
richieste di riquadri 2D e immagini di Street View.
Lo includi come valore di un parametro session
aggiunto a tutte le richieste
URL.
Nell'API Map Tiles, un token di sessione rappresenta un insieme definito di
opzioni di visualizzazione. Ciò significa che non devi passare una serie di opzioni di visualizzazione con
per ogni richiesta di riquadro. Puoi utilizzare lo stesso token di sessione su più client.
Un token di sessione è attualmente valido per due settimane dal suo
ma la situazione potrebbe cambiare. Puoi sempre controllare la scadenza di un
di sessione osservando il campo expiry
nel messaggio di risposta.
Richiesta di token di sessione
Per richiedere un token di sessione, invia una richiesta POST HTTPS a createSession
come mostrato nell'esempio seguente. Devi inviare la richiesta con un
Intestazione Content-Type: application/json
.
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Campi obbligatori
mapType
Il tipo di mappa base. Questo valore può essere uno dei seguenti:
roadmap
- I riquadri di mappe dipinte standard di Google Maps.
satellite
- Immagini satellitari.
terrain
- Immagini del terreno. Quando selezioni
terrain
come tipo di mappa, devi anche includono il tipo di livellolayerRoadmap
(descritto nel Campi facoltativi ). streetview
- Panoramiche in Street View. Per ulteriori informazioni, vedi Riquadri di Street View.
language
Un Tag lingua IETF che specifica la lingua utilizzata per visualizzare le informazioni nei riquadri. Per Ad esempio,
en-US
specifica la lingua inglese parlata negli Stati Uniti.region
R Repository di dati delle impostazioni internazionali comune identificatore di regione (due lettere maiuscole) che rappresenta la località fisica dell'utente. Ad esempio,
US
.
Campi facoltativi
imageFormat
- Specifica il formato del file da restituire. I valori validi sono
jpeg
opng
. I file JPEG non supportano la trasparenza, pertanto non sono consigliati per riquadri sovrapposti. Se non specifichi un valoreimageFormat
, viene utilizzato il formato migliore per il riquadro viene scelto automaticamente. scale
Ridimensiona le dimensioni degli elementi della mappa (come le etichette delle strade), mantenendo il valore dimensioni del riquadro e area di copertura del riquadro predefinito. Aumentando la scala anche riduce il numero di etichette sulla mappa e di conseguenza si riduce il disordine. Le seguenti sono valori
scale
validi:scaleFactor1x
: l'impostazione predefinita.scaleFactor2x
: raddoppia le dimensioni delle etichette e rimuove le etichette delle caratteristiche minori.scaleFactor4x
: quadruplica le dimensioni delle etichette e rimuove le etichette delle caratteristiche minori.
I seguenti esempi mostrano l'effetto del ridimensionamento degli elementi della mappa.
Fattore di scala 1x | Fattore di scala 2x |
---|---|
![]() |
![]() |
highDpi
- Specifica se restituire riquadri ad alta risoluzione. Se il fattore di scala è
aumentato,
highDpi
viene utilizzato per aumentare le dimensioni del riquadro. Generalmente, aumentando il fattore di scala ingrandisce il riquadro risultante in un'immagine del di tutte le dimensioni, con conseguente riduzione della qualità. ConhighDpi
, anche le dimensioni risultanti sono aumentati, preservando la qualità. DPI è l'acronimo di Dots per Inch, mentre High DPI indica il riquadro viene visualizzato usando più punti per pollice del normale. Setrue
, allora il numero di pixel in ciascuna delle dimensioni x e y viene moltiplicato per la scala (ovvero 2x o 4x). L'area di copertura del riquadro rimane invariata. Questo parametro funziona solo con i valoriscale
pari a 2x o 4x. Non ha alcun effetto su 1 riquadro bilancia.
Fattore di scala 1x | Fattore di scala 2x alto DPI |
---|---|
![]() |
![]() |
layerTypes
Un array di valori che specifica i tipi di livelli aggiunti alla mappa. Valido sono:
layerRoadmap
- Obbligatorio se specifichi
terrain
come tipo di mappa. Può anche essere, facoltativamente, sovrapposto al tipo di mappasatellite
. Non ha effetto sui riquadri della roadmap. layerStreetview
- Mostra le strade e le località compatibili con Street View utilizzando i contorni blu sulla mappa.
layerTraffic
- Mostra le condizioni attuali del traffico.
styles
Un array di oggetti in stile JSON che specificano l'aspetto e il livello di dettaglio elementi della mappa come strade, parchi e aree urbane. Lo stile è utilizzato personalizzare la mappa base di Google standard. Il parametro
styles
è valido solo se il tipo di mappa èroadmap
. Per la sintassi completa dello stile, consulta Riferimento di stile.overlay
Un valore booleano che specifica se
layerTypes
deve essere visualizzato come overlay separato o combinato con le immagini di base. Quandotrue
, la mappa base non viene visualizzata. Se non hai definito alcun valorelayerTypes
, questo valore viene ignorato.
Ad esempio, la richiesta di un tipo di mappa satellite
con un livello layerRoadmap
e
overlay
impostato su false
restituisce riquadri equivalenti al tipo di mappa hybrid
utilizzata nell'API Maps JavaScript (immagine a sinistra). Uguale
I tipi di mappa e livelli con l'opzione overlay
impostata su true
mostrano un riquadro trasparente
con una sovrapposizione sulla mappa, con stili adeguati per la sovrapposizione sulle immagini satellitari
(immagine a destra).
overlay : falso |
overlay : vero |
---|---|
![]() |
![]() |
Il seguente JSON è un esempio di corpo di una richiesta tipica che contiene sia campi obbligatori e facoltativi.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
Questo esempio fornisce un overlay adatto all'uso combinato con il satellite immagini. L'esempio contiene sia una mappa stradale che un overlay di Street View. La la mappa risultante viene visualizzata con nomi e dati in lingua inglese, parlata negli Stati Uniti.
apiOptions
: un array di valori che specifica opzioni aggiuntive da applicare.
Le opzioni supportate sono:
MCYJ5E517XR2JC
- Attiva nuova mappa di stile. Durante il periodo di attivazione, le tue richieste riceveranno i dati se questo valore non viene specificato.
Risposta del token di sessione
Il codice JSON seguente è un esempio di corpo della risposta.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
Il seguente elenco contiene le definizioni dei campi nel corpo della risposta.
session
- Un valore del token di sessione che devi includere in tutte le tue API Map Tiles richieste.
expiry
- Una stringa contenente l'ora (in secondi dall'epoca) in cui il token scade. Un token di sessione è valido per due settimane dalla sua creazione in un arco di tempo, ma queste norme potrebbero cambiare senza preavviso.
tileWidth
- La larghezza dei riquadri misurata in pixel.
tileHeight
- L'altezza dei riquadri misurata in pixel.
imageFormat
- Il formato dell'immagine, che può essere
png
ojpeg
.