Riquadri di Street View

Esempio di Street ViewI 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.

  1. Richiedi un token di sessione. Assicurati di impostare il valore di mapType su streetview.

  2. Utilizza il token di sessione per ottenere l'identificatore panorama (panoId) di una o più località geografiche.

  3. Utilizza gli identificatori di panoramiche dalla risposta di ricerca di panoId per ottenere:

    1. Metadati Street View. Puoi ottenere i metadati di Street View anche trasmettendo un insieme di coordinate e un raggio.

    2. Miniature di Street View.

    3. Riquadri di 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 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.

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:

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 e lng, 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 e outdoor.
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

Miniatura di Street View di Whistler, Canada

Parametri obbligatori

panoId
L'ID univoco della miniatura che vuoi usare. Puoi ottenere i valori ID panoramica dall'endpoint panoIds o dall'endpoint metadata, che accettano entrambi 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, 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 a 90 (inclusi). 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 (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.

Il risultato di una richiesta Tile andata a buon fine

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:

Livello di zoom zero

Al livello di zoom cinque, viene utilizzata la panoramica a grandezza originale, suddivisa in riquadri.

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.