Riquadri di Street View

Sviluppatori dello Spazio economico europeo (SEE)

Esempio di Street View Tiles

I riquadri Street View sono simili ai riquadri 2D , ma contengono immagini panoramiche scattate a livello stradale. Con Street View puoi esplorare punti di riferimento in tutto il mondo, scoprire meraviglie della natura ed entrare direttamente in musei, stadi, ristoranti o piccole attività. Questo endpoint API ti dà accesso a:

Riquadri Street View di Google Maps
Metadati di Street View
Miniature di Street View

Puoi unire i riquadri immagine scattati a livello stradale per creare un effetto panoramico realistico. Inoltre, puoi eseguire query su un massimo di 100 ID panoramica per un insieme di località (ad esempio un percorso) e ottenere metadati più approfonditi sulla posizione della fotocamera.

Per unire i riquadri Street View è necessario un visualizzatore. Ad esempio, il visualizzatore panoramico personalizzato di Street View.

Una volta ottenuta una chiave API, puoi accedere alle immagini di Street View seguendo questi passaggi.

Ottieni un token di sessione. Assicurati di impostare il valore di mapType su streetview.
Utilizza il token di sessione per ottenere l'identificatore della panoramica (panoId) di una o più località geografiche.
Utilizza gli identificatori della panoramica dalla risposta di ricerca panoId per ottenere:
1. Metadati di Street View. Puoi anche ottenere i metadati di Street View passando un insieme di coordinate e un raggio.
2. Miniature di Street View.
3. Riquadri Street View.

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 Street View. Puoi recuperare i riquadri Street View a sei livelli di zoom: da 512 pixel fino a 13.312 pixel.
`https://tile.googleapis.com/v1/streetview/panoIds`	Ti consente di cercare in blocco fino a 100 località. Restituisce gli ID panoramica per tutte le località con immagini.
`https://tile.googleapis.com/v1/streetview/thumbnail`	Restituisce un'immagine JPEG in miniatura di una scena di Street View. Ti consente di fornire un orientamento, un'angolazione, le dimensioni e il 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. I dettagli includono l'indirizzo correlato e i link alle panoramiche adiacenti.

Ricerca di panoId di Street View

Puoi trovare l'identificatore della panoramica di una o più località geografiche passando 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 attorno alla località specificata, in cui cercare le panoramiche. Il valore predefinito è 50 metri.

Risposta panoId

L'API Map Tiles tenta di trovare la panoramica più vicina a ogni località, quindi restituisce i relativi ID panoramica. Una richiesta panoIds riuscita restituisce un oggetto JSON che contiene un array panoIds. L'array contiene un elenco di ID panoramica, nell'ordine in cui li hai richiesti. Se l'API Map Tiles non riesce a trovare panoramiche per le località richieste, nell'array viene restituita una stringa vuota in quella località. Per un esempio, consulta il seguente codice JSON.

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

Puoi utilizzare panoIds per:

Richiedere i metadati di Street View
Richiedere le miniature di Street View
Richiedere i riquadri Street View

Metadati di Street View

Le richieste di metadati di Street View recuperano informazioni sulle panoramiche. Una richiesta di metadati di Street View è una richiesta HTTPS GET. Puoi recuperare informazioni sulle panoramiche in due modi:

Se passi un pano_id, l'API Map Tiles restituisce i metadati per quella panoramica.
Se passi un lat e un lng, l'API Map Tiles restituisce i metadati per la panoramica più vicina all'interno del raggio di ricerca specificato.

Passa un insieme di coordinate e 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 panoramica sono temporanei, ti consigliamo di passare un insieme di coordinate e un valore radius nella richiesta iniziale di metadati di Street View. Per un esempio, consulta 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"

Passa 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 risposta tipica 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 questa panoramica. Non fare affidamento sulla validità degli ID panoramica per più di una sessione utente.
lat, lng: Le coordinate (latitudine e longitudine) della panoramica. Questi valori possono essere diversi dalle coordinate che hai passato nella richiesta perché la località viene ancorata alla panoramica più vicina.
imageHeight, imageWidth: Le dimensioni dell'immagine panoramica unita.
tileHeight, tileWidth: Le dimensioni di un singolo riquadro panoramico.
heading: L'orientamento della bussola, misurato in gradi, in senso orario da nord. Le intestazioni vengono restituite nell'intervallo [0,360], con 0 che rappresenta il nord.
tilt: L'inclinazione della panoramica, 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 della panoramica.
roll: La rotazione in senso orario attorno alla linea di visualizzazione applicata alla 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 e outdoor.
date: La data in cui è stata scattata l'immagine. Non tutte le immagini hanno dati sulla data. Tuttavia, quando è disponibile, questo campo contiene una combinazione dell'anno (AAAA) e del 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 gli utenti possono utilizzare per segnalare problemi con questo riquadro di Street View. Devi mostrare questo link ipertestuale nell'angolo in basso a destra dell'immagine e deve includere un testo del link simile a "Segnala un problema con questa immagine".
addressComponent: Un geocodice strutturato Geocode che contiene i dettagli dell'indirizzo della panoramica. Per ulteriori informazioni, consulta Richieste e risposte di geocodifica nella documentazione dell'API Geocoding.
links: Un elenco di ID panoramica che rimandano a questa. Contiene anche l'intestazione in cui si trova il link. Ad esempio, se l'orientamento è 180°, la panoramica collegata si trova a sud della panoramica corrente. Tieni presente che, a causa della natura temporanea degli ID panoramica, non devi fare affidamento su questi per più di una sessione utente.

Miniature di Street View

Puoi richiedere le immagini di Street View in formato thumbnail. Le miniature sono immagini non affiancate con dimensioni, orientamento, angolazione e campo visivo definiti dall'utente. Le immagini in miniatura hanno una risoluzione inferiore rispetto ai riquadri e sono più piccole in termini di dimensioni dei file. Per effettuare una richiesta di miniatura, invia 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 delle 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. Puoi ottenere i valori dell'ID panoramica dall'endpoint panoIds o dall'endpoint metadata, entrambi accettano le coordinate geografiche e restituiscono il panoId appropriato.
session: Un token di sessione valido.
key: La tua chiave API.

Parametri facoltativi

height: Specifica l'altezza della miniatura in pixel, da 16 a 250 pixel. Se non specifichi un'altezza, l'altezza predefinita è il valore massimo consentito di 250 pixel. Se specifichi un valore fuori intervallo, la miniatura viene ancorata al valore valido più vicino.
width: Specifica la larghezza della miniatura in pixel, da 16 a 600 pixel. Se non specifichi una larghezza, la larghezza predefinita è il valore massimo consentito di 600 pixel. Se specifichi un valore fuori intervallo, la miniatura viene ancorata al valore valido più vicino.
pitch: Specifica l'angolo della fotocamera lungo l'asse verticale. I valori validi sono compresi nell' intervallo da -90 a 90 (incluso). Il valore predefinito è 0.
yaw: Specifica la direzione della fotocamera lungo l'asse orizzontale. I valori validi sono compresi nell'intervallo da -360 a 360 (incluso). Il valore predefinito è 0.
fov: Specifica il campo visivo orizzontale, espresso in gradi, con un valore massimo di 120. Quando si ha a che fare con un'area visibile di dimensioni fisse, come nel caso di un'immagine di Street View di dimensioni fisse, il campo visivo rappresenta lo zoom, dove i valori più piccoli specificano un livello di zoom più elevato. Il valore predefinito è 90.

Riquadri immagine di Street View

Una volta ottenuto un panoId, puoi richiedere un riquadro immagine di Street View. Le richieste di riquadri sono richieste HTTPS GET. 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 le coordinate del riquadro di Street View che vuoi. I livelli di zoom nelle panoramiche di Street View devono essere compresi nell'intervallo [0,5], con 0 che 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 Street View

Una richiesta di riquadro Street View riuscita restituisce un'immagine del formato e delle dimensioni specificate nella risposta createSession.

Il risultato di una richiesta di riquadro riuscita

Al livello di zoom zero, l'intera panoramica viene ridimensionata in un riquadro di dimensioni tileWidth x tileHeight. Poiché le panoramiche sono più grandi nella dimensione x, il riquadro conterrà spazio vuoto nella dimensione y:

Livello di zoom zero

Al livello di zoom cinque, viene utilizzata la panoramica a dimensioni intere e suddivisa in riquadri.

Informazioni sul copyright

Devi mostrare le informazioni sul copyright con ogni panoramica in Street View. La stringa da visualizzare può variare a seconda delle panoramiche. Per ottenere le informazioni sul copyright, devi richiedere i metadati di Street View, quindi puoi fare riferimento al campo copyright della risposta. Per ulteriori informazioni, consulta Attribuzioni dei dati.