I riquadri di Street View sono simili ai riquadri 2D, tranne per il fatto che contengono immagini panoramiche scattate a livello della strada. Con Street View puoi esplorare i punti di riferimento di tutto il mondo, vedere meraviglie naturali ed entrare in luoghi quali musei, stadi, ristoranti o piccole attività. Questo endpoint API ti dà accesso a:
- Riquadri di Street View di Google Maps
- Metadati Street View
- Miniature di Street View
Puoi cucire insieme riquadri di immagini scattate a livello della strada per creare un effetto panoramico realistico. Inoltre, puoi eseguire query su fino a 100 ID panoramica per una serie di posizioni (come un percorso) e ottenere metadati più approfonditi sulla posizione della fotocamera.
È necessario un visualizzatore per unire i riquadri di Street View. ad esempio il visualizzatore del panorama personalizzato di Street View.
Una volta ottenuta una chiave API, puoi accedere alle immagini di Street View procedendo nel seguente modo.
Richiedi un token di sessione. Assicurati di impostare il valore di
mapType
sustreetview
.Utilizza il token di sessione per ottenere l'identificatore panorama (panoId) di una o più località geografiche.
Utilizza gli identificatori di panoramiche dalla risposta di ricerca di panoId per ottenere:
Metadati Street View. Puoi ottenere i metadati di Street View anche trasmettendo un insieme di coordinate e un raggio.
Metodi di Street View
Puoi accedere alle immagini e ai metadati di Street View chiamando uno dei seguenti quattro metodi.
Metodo | Descrizione |
---|---|
https://tile.googleapis.com/v1/streetview/tiles |
Restituisce i singoli riquadri di Street View. Puoi recuperare i riquadri di Street View a sei livelli di zoom: da 512 pixel a 13.312 pixel. |
https://tile.googleapis.com/v1/streetview/panoIds |
Consente di effettuare ricerche collettive fino a 100 località. Restituisce gli ID delle panoramiche per tutte le posizioni con immagini. |
https://tile.googleapis.com/v1/streetview/thumbnail |
Restituisce un'immagine JPEG in miniatura di una scena di Street View. Ti consente di specificare intestazione, presentazione, dimensioni e campo visivo. Le dimensioni minime sono 16 x 16 pixel. Le dimensioni massime sono 250 x 600 pixel. |
https://tile.googleapis.com/v1/streetview/metadata |
Fornisce informazioni dettagliate sulla panoramica specificata. che includono l'indirizzo correlato e i link a panoramiche adiacenti. |
Ricerca di panorami di Street View
Per trovare l'identificatore del panorama di una o più posizioni geografiche,
passa le relative coordinate (lat
, lng
) al metodo panoIds
. Il corpo della richiesta è un oggetto JSON che contiene un array locations
e, facoltativamente, un radius
, come mostrato nel seguente esempio di codice JSON.
curl -X POST -d '{ "locations": [ {"lat": -33.883837, "lng": 151.209307}, {"lat": -33.883700, "lng": 151.210307}, {"lat": 0, "lng": 0} ], "radius": 50 }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY"
locations
- L'array
locations
deve contenere almeno un insieme di valori di coordinate, ma puoi includerne altri, fino a un massimo di 100. radius
- Il valore
radius
(misurato in metri) definisce il raggio del cerchio intorno alla località specifica in cui cercare i panorami. Il valore predefinito è 50 metri.
Risposta PanoId
L'API Map Tiles cerca di trovare il panorama più vicino a ogni località, poi restituisce gli ID delle panoramiche corrispondenti. Una richiesta panoIds
andata a buon fine restituisce un
oggetto JSON che contiene un array panoIds
. L'array contiene un elenco di ID panorama, nell'ordine in cui li hai richiesti. Se l'API Map Tiles
non riesce a trovare panoramiche per le località richieste, viene restituita una stringa vuota
in quella posizione nell'array. Ad esempio, vedi il codice JSON seguente.
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
Puoi utilizzare panoIds
per:
- Richiedere i metadati di Street View
- Richiedere miniature di Street View
- Richiedere i riquadri di Street View
Metadati Street View
Le richieste di metadati di Street View recuperano informazioni sui panorami. Una richiesta di metadati Street View è una richiesta HTTPS GET. Puoi recuperare le informazioni sulle panoramiche in due modi:
Se superi un
pano_id
, l'API Map Tiles restituisce i metadati per tale panorama.Tuttavia, se superi
lat
elng
, l'API Map Tiles restituisce i metadati per la panoramica più vicina entro il raggio di ricerca specificato.
Trasmettere un insieme di coordinate e di un raggio
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY &lat=lat &lng=lng &radius=meters"
Poiché gli ID delle panoramiche sono temporanei, ti consigliamo di trasmettere un insieme di coordinate e un valore radius
nella richiesta iniziale di metadati di Street View.
Ad esempio, vedi il seguente snippet di codice.
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &lat=47.62066 &lng=-122.34923 &radius=50"
Trasmetti il panoId di un'immagine di Street View
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
Risposta dei metadati
Il seguente codice JSON è un esempio di una tipica risposta dei metadati.
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
"addressComponents": [
{
"longName": "United States",
"shortName": "United States",
"types": [
"country"
]
},
{
"longName": "Mountain View, California",
"shortName": "Mountain View, California",
"types": [
"locality"
]
},
{
"longName": "Charleston Rd",
"shortName": "Charleston Rd",
"types": [
"route"
]
},
{
"longName": "1635",
"shortName": "1635",
"types": [
"street_number"
]
}
],
"links": [
{
"panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
"heading": 274.47998046875,
"text": "Charleston Rd"
},
{
"panoId": "1cODYwFRw1aZ45IignDIMw",
"heading": 94.47999572753906,
"text": "Charleston Rd"
}
]
}
Il seguente elenco contiene le definizioni dei campi nel corpo della risposta.
panoId
- L'ID univoco di questo panorama. Non fare in modo che gli ID Panorama siano validi per più di una singola sessione utente.
lat
,lng
- Le coordinate (latitudine e longitudine) del panorama. Questi valori possono essere diversi dalle coordinate che hai passato nella richiesta, in quanto la posizione si aggancia al panorama più vicino.
imageHeight
,imageWidth
- Le dimensioni dell'immagine panoramica unita.
tileHeight
,tileWidth
- Le dimensioni di un singolo riquadro del panorama.
heading
- Direzione della bussola, misurata in gradi, in senso orario da nord. Le intestazioni vengono restituite nell'intervallo [0,360], dove 0 rappresenta il nord.
tilt
- L'inclinazione del panorama, misurata in gradi dal polo sud della panoramica all'orizzonte. I valori restituiti sono compresi nell'intervallo [0, 180]. Un valore di 90 gradi indica che l'orizzonte è già allineato all'equatore del panorama.
roll
- La rotazione in senso orario della linea dello sguardo applicata alla panoramica per allineare l'orizzonte. I valori restituiti sono compresi nell'intervallo [0, 360].
imageryType
- Indica il tipo di immagine. I valori validi sono
indoor
eoutdoor
. date
- La data in cui è stata scattata l'immagine. Non tutte le immagini contengono dati sulla data. Tuttavia, se disponibile, questo campo contiene una combinazione di anno (AAAA) e mese (MM). Ad esempio: 2023-05 o 2024.
copyright
- Il testo del copyright che devi mostrare come attribuzione insieme all'immagine di Street View.
reportProblemLink
- Un link ipertestuale che i tuoi utenti possono utilizzare per segnalare problemi con questo riquadro Street View. Devi mostrare questo link ipertestuale nell'angolo in basso a destra dell'immagine e deve includere il testo del link, ad esempio "Segnala un problema con questa immagine".
addressComponent
- Un codice geografico strutturato contenente i dettagli relativi all'indirizzo della panoramica. Per ulteriori informazioni, consulta la sezione Richieste e risposte di geocodifica nella documentazione dell'API Geocoding.
links
- Un elenco di ID panoramica collegati a questo. Contiene anche l'intestazione in cui si trova il link. Ad esempio, se l'intestazione è a 180°, la panoramica collegata deve trovarsi a sud della panoramica corrente. Tieni presente che, a causa della natura temporanea degli ID delle panoramiche, non devi utilizzarli per più di una singola sessione utente.
Miniature di Street View
Puoi richiedere le immagini di Street View in formato thumbnail
. Le miniature sono
immagini senza riquadri con dimensioni, intestazione, tono e campo visivo definiti dall'utente.
Le immagini in miniatura hanno una risoluzione inferiore rispetto ai riquadri e sono di dimensioni inferiori. Puoi effettuare una richiesta di miniatura inviando una richiesta GET all'endpoint thumbnail
, come mostrato nel seguente prototipo di codice.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId &height=FROM_16_TO_250 &width=FROM_16_TO_600 &pitch=FROM-90_TO_90 &yaw=FROM-360_TO_360 &fov=FROM_30_TO_120"
Considera il seguente esempio di codice, che scarica una miniatura di immagini di Street View scattate a Whistler, in Canada.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=Zzl28rqGJgaL2IdkUleP8A &height=200 &width=200 &pitch=0 &yaw=250 &fov=80" --output /tmp/example_thumbnail.png
Parametri obbligatori
panoId
- L'ID univoco della miniatura che vuoi usare. Puoi ottenere i valori ID panoramica
dall'endpoint
panoIds
o dall'endpointmetadata
, che accettano entrambi le coordinate geografiche e restituiscono ilpanoId
appropriato. session
- Un token di sessione valido.
key
- La tua chiave API.
Parametri facoltativi
height
- Specifica l'altezza della miniatura in pixel, con un intervallo compreso tra 16 e 250 pixel. Se non specifichi un'altezza, il valore predefinito sarà di 250 pixel. Se specifichi un valore fuori intervallo, la miniatura si aggancia al valore valido più vicino.
width
- Specifica la larghezza della miniatura in pixel, che va da 16 a 600 pixel. Se non specifichi una larghezza, per impostazione predefinita viene applicato il valore massimo consentito di 600 pixel. Se specifichi un valore fuori intervallo, la miniatura si aggancia al valore valido più vicino.
pitch
- Specifica l'angolazione della fotocamera lungo l'asse verticale. I valori validi sono compresi nell'intervallo
da
-90
a90
(inclusi). Il valore predefinito è 0. yaw
- Specifica la direzione della fotocamera lungo l'asse orizzontale. I valori validi sono compresi nell'intervallo da
-360
a360
(inclusi). Il valore predefinito è 0. fov
- Specifica il campo visivo orizzontale, espresso in gradi, con un valore massimo di 120. Nel caso di un'area visibile di dimensioni fisse, come nel caso di un'immagine di Street View di dimensioni prestabilite, il campo visivo rappresenta lo zoom, mentre i valori più piccoli specificano un livello di zoom più elevato. Il valore predefinito è 90.
Riquadri di immagini di Street View
Quando hai un panoId
, puoi richiedere un riquadro di un'immagine di Street View. Le richieste Tile sono richieste GET HTTPS. Considera il seguente esempio.
curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
In questo esempio di codice, z
è il livello di zoom, mentre x
e y
sono le coordinate dei riquadri del riquadro Street View che ti interessa. I livelli di zoom nelle panoramiche Street View devono essere compresi nell'intervallo [0,5], dove 0 rappresenta il campo visivo più ampio.
Livello di zoom | Campo visivo approssimativo |
---|---|
0 | 360° |
1 | 180° |
2 | 90° |
3 | 45° |
4 | 22,5° |
5 | 11,25 ° |
Risposte dei riquadri di Street View
Una richiesta di riquadro Street View andata a buon fine restituisce un'immagine del formato e delle dimensioni
specificate nella risposta createSession
.
A livello di zoom pari a zero, l'intero panorama viene ridimensionato in un riquadro con le dimensioni tileWidth
di tileHeight
. Poiché le panoramiche sono più grandi nella dimensione x,
il riquadro conterrà uno spazio vuoto nella dimensione y:
Al livello di zoom cinque, viene utilizzata la panoramica a grandezza originale, suddivisa in riquadri.
Informazioni sul copyright
In ogni panoramica di Street View è necessario inserire le informazioni sul copyright. La stringa da visualizzare può variare da una panoramica all'altra. Per ottenere le informazioni sul copyright,
devi richiedere i metadati di Street View. Dopodiché puoi
consultare il campo copyright
della risposta. Per maggiori informazioni, consulta
Attribuzioni dei dati.