Richiesta e risposta Street View

Una richiesta di immagine di Street View è un URL HTTP nel seguente formato:

https://maps.googleapis.com/maps/api/streetview?parameters

L'immagine viene specificata utilizzando i parametri di richiesta. Come standard in Negli URL, tutti i parametri vengono separati dal carattere e commerciale (&). I parametri consentiti e i relativi valori possibili sono elencati di seguito.

Parametri obbligatori

Procedi in uno dei seguenti modi:

  • location può essere una stringa di testo (ad esempio Chagrin Falls, OH) o una coppia di coordinate di latitudine e longitudine (40.457375,-80.009353), e deve avere la codifica dell'URL. Quindi converti indirizzi quali "Via Roma, RM" a "City+Hall,New+York,NY" prima di inviare la richiesta. L'API Street View Static scatta sulla fotografia panoramica più vicina a la posizione. Quando fornisci una stringa di testo per l'indirizzo, l'API potrebbe utilizzare cambiare la posizione della fotocamera per visualizzare meglio la posizione specificata. Quando fornisci le coordinate di latitudine e longitudine, l'API cerca in un raggio di 50 metri la fotografia più vicina al luogo. Poiché le immagini di Street View vengono aggiornate periodicamente e le fotografie potrebbero essere presa da posizioni leggermente diverse ogni volta, è possibile che location potrebbe scattare a una panoramica diversa quando le immagini vengono aggiornate.

Oppure:

  • pano è un ID panoramica specifico. L'ID dei panorami può cambiare nel tempo, quindi non mantenere questo ID. Salva invece l'indirizzo della posizione o coordinate di latitudine e longitudine per poter aggiornare l'ID del panorama. Per consulta Aggiornare gli ID dei panorami eliminati.

Inoltre:

  • size specifica le dimensioni di output dell'immagine in pixel. La dimensione è specificata come {width}x{height}, ad esempio size=600x400 restituisce un'immagine larga 600 pixel e alta 400 pixel.
  • key consente di monitorare l'utilizzo dell'API da parte dell'applicazione nella Console Google Cloud, e garantisce che Google possa contattarti in merito alla tua richiesta, se necessario. Per ulteriori informazioni, consulta l'articolo Ottenere una chiave e una firma.

Aggiorna gli ID panoramiche eliminati

Se tenti di recuperare l'ID di un panorama e ottieni ZERO_RESULTS o nessun valore, significa che l'ID panoramica è stato eliminato e deve essere aggiornato.

  1. Salva l'indirizzo della posizione o le coordinate di latitudine e longitudine utilizzati in precedenza ottenere un ID panoramica per poter aggiornare quando necessario.

  2. Quando rilevi che l'ID di una panoramica è cambiato, utilizza la posizione originale. indirizzo o coordinate di latitudine e longitudine per cercare di nuovo panoramiche in quella posizione e ottenere un nuovo ID panoramica.

Parametri facoltativi

  • signature (consigliata) è una firma digitale utilizzata per verificare che le richieste che generano richieste da siti utilizzando la tua chiave API siano autorizzate per farlo. Le richieste che non includono una firma digitale potrebbero non andare a buon fine. Per ulteriori informazioni, consulta l'articolo Ottenere una chiave e una firma.

    Nota: per gli ex clienti del piano Premium di Google Maps Platform, il è necessaria la firma. Ulteriori informazioni su dei parametri di autenticazione Clienti con un piano Premium.

  • heading indica l'orientamento della bussola di la fotocamera. I valori accettati sono compresi tra 0 e 360 (entrambi i valori indicano il nord, con 90 che indica Est e 180 sud). Se non specifichi un'intestazione, viene assegnato un valore calcolata che indirizzi la fotocamera verso il location, dal punto in cui è stata posizionata la fotografia più vicina prese.
  • fov (il valore predefinito è 90) determina il campo visivo orizzontale dell'immagine espresso in gradi, con un valore massimo consentito di 120. In caso di area visibile di dimensioni fisse, come nel caso di un'immagine di Street View di una imposta le dimensioni, il campo visivo in sostanza rappresenta lo zoom, con numeri più piccoli che indicano un livello di zoom più elevato.


    Screenshot di un campo visivo ampio, che mostra il soffitto, le pareti, il pavimento e la finestra della vasca all'interno di un acquario. Screenshot di un campo visivo ravvicinato che mostra i dettagli con lo zoom aumentato di una foto di Street View all'interno di un acquario.
    (Sinistra: fov=120; Destra: fov=20)

  • pitch (il valore predefinito è 0) specifica l'angolazione verso l'alto o verso il basso della fotocamera rispetto all'immagine di Street View veicolo. Spesso, ma non sempre, è orizzontale. Valori positivi punta la fotocamera verso l'alto (con 90 gradi che indicano che il dispositivo è dritto verso l'alto); valori negativi che puntano la fotocamera verso il basso (con -90 che indica verso il basso).
  • radius (il valore predefinito è 50) consente di impostare un raggio, specificato in metri, in cui cercare una panoramica, centrata sulla latitudine e sulla longitudine specificate. I valori validi sono non negativi numeri interi.
  • return_error_code indica se l'API deve restituire un codice di errore quando non viene trovata alcuna immagine (404 NON TROVATA) o in risposta a un richiesta non valida (400 BAD REQUEST). I valori validi sono true e false. Se impostato su true, viene visualizzato un messaggio di errore al posto dell'immagine grigia generica. In questo modo non è necessario effettua una chiamata separata per verificare la disponibilità delle immagini.
  • source (il valore predefinito è default) limita le ricerche di Street View alle fonti selezionate. I valori validi sono:
    • default utilizza le origini predefinite per Street View; le ricerche non si limitano a fonti specifiche.
    • outdoor limita le ricerche alle raccolte di contenuti all'aperto. Da interno raccolte non sono incluse nei risultati di ricerca. Tieni presente che le panoramiche all'aperto potrebbero non esistere per la località specificata. Tieni inoltre presente che la ricerca restituisce solo panoramiche. dove è possibile determinare se si trovano al chiuso o all'esterno. Ad esempio: Le PhotoSphere non vengono restituite perché non è noto se si trovano all'interno o all'esterno.

Questa è una richiesta di esempio.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Uno screenshot di una foto di un punto di osservazione a livello stradale che mostra i binari elettrificati della ferrovia.

Nessuna immagine disponibile

Per le località in cui le immagini di Street View non sono disponibili, utilizza l'API Street View Static restituisce un'immagine generica grigia con il testo "Spiacenti, non sono disponibili immagini qui.", come mostrato in questo esempio:

Uno screenshot dell'immagine generica visualizzata quando non sono disponibili immagini per la località specificata. Lo sfondo è marrone chiaro e mostra il testo "Spiacenti, non abbiamo immagini qui".
Figura: un'immagine generica viene visualizzata quando non sono disponibili immagini per il località specificata.

Mostra solo immagini valide

Per evitare di visualizzare l'immagine generica e assicurati che la pagina web visualizza solo immagini valide dell'API Street View Static, segui queste suggerimenti:

  • Imposta il parametro return_error_code su true. Questo fa sì che l'API Street View Static restituisca un errore 404 NOT FOUND invece dell'immagine generica grigia, se non è disponibile alcuna immagine per località specificata.
  • Richiedere i metadati delle immagini di Street View per determinare se sono disponibili immagini per la località specificata prima all'invio di una richiesta.