Riquadri di Street View

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

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

  2. Utilizza il token di sessione per Ottenere l'identificatore panoramica (panoId) di una o più aree geografiche luoghi.

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

    1. Metadati Street View. Puoi anche vedere le indicazioni stradali Visualizza i metadati trasmettendo un insieme di coordinate e un raggio.

    2. Miniature di Street View.

    3. Riquadri di Street View.

di Gemini Advanced.

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.

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:

di Gemini Advanced.

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

Miniatura di Street View di Whistler, Canada

Parametri obbligatori

panoId
L'ID univoco della miniatura che vuoi usare. Puoi ottenere i valori dell'ID panorama dall'endpoint panoIds o dall' Endpoint metadata: entrambi accettano dati geografici e restituisce i valori panoId 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 a 90 (incluso). Il valore predefinito è 0.
yaw
Specifica la direzione della fotocamera lungo l'asse orizzontale. 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 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.

Il risultato di una richiesta Tile andata a buon fine

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:

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 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.