I riquadri di Street View sono simili a
Riquadri 2D
ad eccezione del fatto che contengono immagini panoramiche scattate a livello della strada. Con
Street View ti permette di esplorare punti di riferimento in tutto il mondo, vedere le meraviglie della natura e fare passi
all'interno di luoghi come 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 effetto panoramico reale. Inoltre puoi eseguire query su un massimo di 100 ID panoramica per un set di luoghi (come un percorso) e ottieni metadati più approfonditi sulla videocamera posizione.
È necessario un visualizzatore per unire i riquadri di Street View. Ad esempio, Street View visualizzatore panorama personalizzato.
Una volta ottenuta una chiave API, puoi accedere alle immagini di Street View eseguendo i seguenti passaggi.
Richiedi un token di sessione. Assicurati che per impostare il valore di
mapType
sustreetview
.Utilizza il token di sessione per Ottenere l'identificatore panoramica (panoId) di una o più aree geografiche luoghi.
Utilizza gli identificatori di panoramiche dalla risposta di ricerca di panoId per ottenere:
Metadati Street View. Puoi anche vedere le indicazioni stradali Visualizza i metadati trasmettendo un insieme di coordinate e un raggio.
Metodi di Street View
Puoi accedere alle immagini e ai metadati di Street View in uno dei seguenti modi 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 individuare l'identificatore della panoramica di una o più posizioni geografiche puoi utilizzare
passando le relative coordinate (lat
, lng
) al metodo panoIds
. La richiesta
corpo è un oggetto JSON che contiene un array locations
e, facoltativamente, un
radius
, come mostrato nell'esempio di codice JSON seguente.
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 panoramiche. Il valore predefinito è di 50 metri.
Risposta PanoId
L'API Map Tiles cerca di trovare il panorama più vicino a ciascun luogo e
quindi restituisce gli ID delle panoramiche. Una richiesta panoIds
andata a buon fine restituisce un
Oggetto JSON che contiene un array panoIds
. L'array contiene un elenco
ID panoramiche, nell'ordine in cui li hai richiesti. Se API Map Tiles
non riesce a trovare panoramiche per le località richieste, viene visualizzato un
viene restituita in quella posizione nell'array. Per un esempio, vedi
seguendo il codice JSON.
{
"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 via La richiesta di visualizzazione dei metadati è una richiesta GET HTTPS. Puoi recuperare le informazioni sui panorami in uno dei due seguenti modi:
Se superi un
pano_id
, l'API Map Tiles restituisce i relativi metadati. panoramica.Ma 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, consigliamo di trasmettere un insieme
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 affidamento sul fatto che gli ID Panorama siano valida per più di una singola sessione utente.
lat
,lng
- Le coordinate (latitudine e longitudine) del panorama. Questi valori possono essere diverse da quelle che hai passato nella richiesta perché 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 sono restituito all'interno dell'intervallo [0,360], dove 0 rappresenta due nord.
tilt
- L'inclinazione del panorama, misurata in gradi dal polo sud del 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 di il panorama.
roll
- La rotazione in senso orario intorno alla linea dello sguardo applicata allo panoramica per livellare 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. Ma quando è 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 alla via Visualizza immagine.
reportProblemLink
- Un link ipertestuale che gli utenti possono utilizzare per segnalare problemi relativi a questa immagine di Street View riquadro. Questo link ipertestuale deve essere visualizzato nell'angolo in basso a destra della immagine e deve includere il testo di un link, ad esempio "Segnala un problema con questa immagine".
addressComponent
- Un modello strutturato Geocodifica contenente i dettagli sull'indirizzo della panoramica. Per ulteriori informazioni, vedi 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 viene trovato il link. Ad esempio, se l'intestazione è a 180°, la panoramica collegata deve trovarsi a sud di quella corrente. Tieni presente che, a causa di la natura temporanea degli ID delle panoramiche, non li dovresti fare affidamento per ulteriori rispetto a una singola sessione utente.
Miniature di Street View
Puoi richiedere le immagini di Street View in formato thumbnail
. Le miniature sono
immagini non affiancate con dimensioni, intestazione, tono e campo visivo definiti dall'utente.
Le immagini in miniatura hanno una risoluzione inferiore rispetto ai riquadri e sono più piccole nel file
dimensioni. Puoi effettuare una richiesta di miniatura inviando una richiesta GET a thumbnail
come dimostrato 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 Street View immagini 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 dell'ID panorama
dall'endpoint
panoIds
o dall' Endpointmetadata
: entrambi accettano dati geografici e restituisce i valoripanoId
appropriati. session
- Un token di sessione valido.
key
- La tua chiave API.
Parametri facoltativi
height
- Specifica l'altezza della miniatura in pixel, che va da 16 a 250 pixel. Se non specifichi un'altezza, il valore predefinito sarà valore massimo consentito di 250 pixel. Se specifichi un valore che non rientra nell'intervallo, allora la miniatura si aggancia al valore valido più vicino.
width
- Specifica la larghezza della miniatura in pixel, da 16 a 600 pixel. Se non specifichi una larghezza, il valore predefinito sarà quello massimo consentito di 600 pixel. Se specifichi un valore che non rientra nell'intervallo, la miniatura si aggancia al valore valido più vicino.
pitch
- Specifica l'angolazione della fotocamera lungo l'asse verticale. I valori validi sono in
l'intervallo da
-90
a90
(incluso). Il valore predefinito è 0. yaw
- Specifica la direzione della fotocamera lungo l'asse orizzontale. 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 pari a 120. In caso di area visibile di dimensioni fisse, come in Street View immagine di una dimensione prestabilita, il campo visivo rappresenta lo zoom; in cui 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. Piastrelle
sono richieste GET HTTPS. Considera l'esempio seguente:
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 e
x
e y
sono i
coordinate dei riquadri
del riquadro Street View che ti interessa. I livelli di zoom nelle panoramiche Street View devono
essere compresa 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
da te specificato nella risposta createSession
.
A livello di zoom pari a zero, l'intera panoramica viene ridimensionata in un riquadro di dimensioni.
tileWidth
per 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
la stringa da visualizzare può variare da una panoramica all'altra. Per ottenere le informazioni sul copyright,
devi richiedere i metadati di Street View e poi puoi
fai riferimento al campo copyright
della risposta. Per ulteriori informazioni, vedi
Attribuzioni dei dati.