Street View

Seleziona la piattaforma: Android iOS JavaScript

Google Maps Street View ti consente di esplorare luoghi in tutto il mondo tramite immagini a livello stradale a 360 gradi. Puoi esplorare punti di riferimento in tutto il mondo, ammirare meraviglie naturali, pianificare un viaggio o mostrare l'esterno della tua attività.

Panoramica

Google Street View fornisce visualizzazioni panoramiche a 360 gradi da strade designate in tutta la sua area di copertura. La copertura disponibile tramite l'SDK è la stessa di quella per l'app Google Maps per iOS o https://maps.google.com/. Puoi scoprire di più su Street View e vedere le aree supportate su una mappa interattiva nella pagina Informazioni su Street View.

Maps SDK for iOS fornisce un servizio Street View per ottenere e manipolare le immagini utilizzate in Google Maps Street View. Le immagini di Street View vengono restituite come panorami e visualizzate all'interno del visualizzatore di Street View, un oggetto di tipo GMSPanoramaView.

Panoramiche in Street View

Ogni panoramica in Street View è un'immagine o un insieme di immagini che fornisce una visualizzazione completa a 360 gradi da una singola posizione. Le immagini sono conformi alla proiezione equirettangolare (Plate Carrée), che contiene 360 gradi di visualizzazione orizzontale (un avvolgimento completo) e 180 gradi di visualizzazione verticale (da dritto in alto a dritto in basso). Il panorama a 360 gradi risultante definisce una proiezione su una sfera con l'immagine avvolta sulla superficie bidimensionale di quella sfera.

I panorami di Street View sono visualizzabili con l'oggetto GMSPanoramaView. Questo oggetto fornisce un visualizzatore che renderizza il panorama come una sfera, con una videocamera al centro. Puoi controllare a livello di programmazione l'orientamento della videocamera, nonché diverse proprietà che personalizzano il visualizzatore.

Accedere ai dati di Street View

I panorami di Street View sono identificati da uno dei due metadati:

panoramaID
L'ID univoco di una panoramica in Street View. Questo panoramaID può cambiare nel tempo e non è adatto come riferimento a lungo termine o hardcoded, Il panoramaID è ideale per fornire l'accesso programmatico a diverse immagini di Street View.
coordinate
La posizione esatta di questa immagine, espressa come CLLocationCoordinate2D. Utilizza un coordinate per l'archiviazione permanente di una posizione panoramica o per tradurre le azioni dell'utente sulla mappa in un'immagine di Street View.

Sia panoramaID sia coordinate vengono memorizzati come proprietà dell'oggetto GMSPanorama. Puoi richiedere un GMSPanorama da GMSPanoramaService utilizzando coordinate o panoramaID. L'oggetto risultante includerà entrambi i metadati, nonché un array di link ai panorami nelle vicinanze.

Impostare la posizione del panorama

La posizione della Panoramica in Street View può essere impostata in base alle coordinate.

  • Il metodo moveNearCoordinate richiede un panorama vicino alle coordinate.

  • Il metodo moveNearCoordinate:radius è simile, ma ti consente di specificare un raggio di ricerca, in metri, intorno alle coordinate.

  • Il metodo moveNearCoordinate:source ti consente di specificare una sorgente. Una sorgente è utile se vuoi limitare Street View alla ricerca di panorami esterni. Per impostazione predefinita, i panorami delle località sono interni o esterni. Tieni presente che i panorami esterni potrebbero non esistere per la località specificata.

  • Il metodo moveNearCoordinate:radius:source ti consente di specificare sia un raggio sia una sorgente.

Visualizzare le immagini di Street View

Aggiungere un visualizzatore di Street View

I passaggi di base per aggiungere un visualizzatore sono:

  1. (Una volta) Segui i passaggi descritti nella Guida introduttiva per ottenere l'SDK, un codice e aggiungere i framework richiesti.
  2. Crea o aggiorna un ViewController. Se il panorama verrà visualizzato quando questo controller di visualizzazione diventa visibile, assicurati di crearlo all'interno del metodo loadView.
  3. Crea e crea un'istanza di una classe GMSPanoramaView utilizzando il metodo GMSPanoramaView initWithFrame:. Se deve essere utilizzata come unica visualizzazione del controller di visualizzazione, è possibile utilizzare CGRectZero come frame della mappa. Le dimensioni della mappa verranno modificate automaticamente.
  4. Imposta l'oggetto GMSPanoramaView come visualizzazione del controller di visualizzazione. Ad esempio, self.view = panoView;.
  5. Imposta la posizione dell'immagine di Street View utilizzando un metodo come moveNearCoordinate:.

L'esempio riportato di seguito aggiunge un visualizzatore di Street View a un'app.

Swift

import GoogleMaps

class StreetView: UIViewController {

  override func loadView() {
    let panoView = GMSPanoramaView(frame: .zero)
    self.view = panoView

    panoView.moveNearCoordinate(CLLocationCoordinate2D(latitude: -33.732, longitude: 150.312))
  }
}

Objective-C

#import "StreetView.h"
@import GoogleMaps;

@interface StreetView ()

@end

@implementation StreetView

- (void)loadView {
  GMSPanoramaView *panoView = [[GMSPanoramaView alloc] initWithFrame:CGRectZero];
  self.view = panoView;

  [panoView moveNearCoordinate:CLLocationCoordinate2DMake(-33.732, 150.312)];
}

@end

Personalizzare il visualizzatore

Puoi personalizzare il visualizzatore limitando i gesti disponibili. Per impostazione predefinita, sono abilitati la panoramica, lo zoom e lo spostamento ai panorami adiacenti. I singoli gesti vengono controllati tramite le proprietà di GMSPanoramaView. Queste proprietà attivano o disattivano i gesti controllati dall'utente; le modifiche programmatiche sono comunque possibili quando il gesto è disattivato.

orientationGestures
Indica se l'utente potrà riorientare la videocamera toccando o trascinando. Imposta su NO per disattivare le modifiche all'orientamento della videocamera.
zoomGestures
Indica se l'utente potrà pizzicare per ingrandire. Imposta su NO per disattivare lo zoom.
navigationGestures
Indica se l'utente potrà modificare il panorama visibile. Gli utenti possono toccare una volta i link di navigazione o toccare due volte la visualizzazione per modificare i panorami. Imposta su NO per disattivare le modifiche alla navigazione.

Puoi attivare o disattivare tutti i gesti contemporaneamente con il metodo setAllGesturesEnabled:.

Swift

panoView.setAllGesturesEnabled(false)

Objective-C

[panoView setAllGesturesEnabled:NO];

Avviare Street View con lo schema URL

Le immagini di Google Street View sono visualizzabili dall'interno dell'applicazione Google Maps per iOS. Puoi avviare l'applicazione Google Maps per iOS in modalità Street View con lo schema URL comgooglemaps impostando il parametro mapmode su streetview. Di seguito è riportato un esempio di URL che avvierà Street View. Per saperne di più, consulta la documentazione dello schema URL.

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Località di Street View e punto di vista (POV)

GMSPanoramaCamera ti consente di impostare il punto di vista della videocamera di Street View come combinazione di direzione, inclinazione e zoom.

I seguenti snippet imposteranno la videocamera verso sud e leggermente verso il basso.

Swift

panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)

Objective-C

panoView.camera = [GMSPanoramaCamera cameraWithHeading:180
                                                 pitch:-10
                                                  zoom:1];

Orientamento

La località di Street View definisce il posizionamento della messa a fuoco della videocamera per un'immagine, ma non definisce l'orientamento della videocamera per quell'immagine. A questo scopo, l'oggetto GMSOrientation definisce due proprietà:

  • heading definisce l'angolo di rotazione attorno al locus della videocamera in gradi rispetto al nord vero. Le direzioni vengono misurate in senso orario: il nord vero è 0, l'est è 90, il sud è 180, l'ovest è 270.
  • pitch (valore predefinito 0) definisce la variazione dell'angolo "verso l'alto" o "verso il basso" rispetto all'inclinazione predefinita iniziale della videocamera, che spesso (ma non sempre) è orizzontale. (Ad esempio, un'immagine scattata su una collina avrà probabilmente un'inclinazione predefinita non orizzontale.) Gli angoli di inclinazione vengono misurati con valori positivi verso l'alto (fino a +90 gradi verso l'alto e ortogonali all'inclinazione predefinita) e valori negativi verso il basso (fino a -90 gradi verso il basso e ortogonali all'inclinazione predefinita).

Zoom

Street View supporta diversi livelli di dettaglio dell'immagine tramite l'utilizzo dello zoom. Puoi impostare il livello di zoom a livello di programmazione oppure gli utenti possono modificare il livello nel visualizzatore pizzicando per ingrandire.

Spostare la videocamera

Dopo aver creato GMSPanoramaView e aver configurato o impostato la videocamera predefinita, puoi modificarla in diversi modi. Quando modifichi la videocamera, puoi animare il movimento della videocamera risultante. L'animazione interpola tra gli attributi della videocamera corrente e i nuovi attributi della videocamera.

Puoi modificare l'oggetto GMSPanoramaCamera e impostarlo sulla proprietà camera di GMSPanoramaView. In questo modo, la videocamera si sposterà sul nuovo punto di vista senza animazione. È possibile creare un GMSCameraPosition per configurare qualsiasi combinazione di orientamento e zoom.

Swift

panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)

Objective-C

panoView.camera = [GMSPanoramaCamera cameraWithHeading:180
                                                 pitch:-10
                                                  zoom:1];

Puoi animare una transizione chiamando il metodo animateToCamera:animationDuration: di GMSPanoramaView. Inoltre, puoi controllare la videocamera utilizzando Core Animation. Questa funzionalità è disponibile tramite il CALayer personalizzato su GMSPanoramaView, GMSPanoramaLayer.

Indicatori in Street View

L'oggetto GMSPanoramaView è in grado di visualizzare gli indicatori della mappa. Puoi utilizzare lo stesso oggetto GMSMarker su un oggetto GMSMapView o GMSPanoramaView impostando le proprietà corrispondenti:

Swift

// Create a marker at the Eiffel Tower
let position = CLLocationCoordinate2D(latitude: 48.858, longitude: 2.294)
let marker = GMSMarker(position: position)

// Add the marker to a GMSPanoramaView object named panoView
marker.panoramaView = panoView

// Add the marker to a GMSMapView object named mapView
marker.map = mapView

Objective-C

// Create a marker at the Eiffel Tower
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(48.858,2.294);
GMSMarker *marker = [GMSMarker markerWithPosition:position];

// Add the marker to a GMSPanoramaView object named panoView
marker.panoramaView = panoView;

// Add the marker to a GMSMapView object named mapView
marker.map = mapView;

Le dimensioni degli indicatori verranno scalate in base alla distanza tra la posizione dell'indicatore e la posizione di GMSCameraView. Se questa distanza diventa troppo elevata, l'indicatore diventerà troppo piccolo per essere visualizzato e verrà nascosto.

Imposta la proprietà panoramaView su nil per rimuoverla da GMSPanoramaView.

Swift

marker.panoramaView = nil

Objective-C

marker.panoramaView = nil;

Eventi

Puoi rimanere in ascolto degli eventi che si verificano nella Panoramica in Street View, ad esempio quando un utente tocca la panoramica. Per ascoltare gli eventi, devi implementare il GMSPanoramaViewDelegate protocollo. Consulta la guida generale agli eventi e l'elenco dei metodi in GMSPanoramaViewDelegate.