Google Street View offre viste panoramiche a 360° dalle strade designate. in tutta l'area di copertura.
Questo video mostra come utilizzare il servizio Street View per offrire agli utenti un'esperienza reale di un indirizzo sulla mappa, fornendo un contesto significativo sulla loro destinazione o sul luogo a cui sono interessati.
La copertura disponibile tramite Google Maps L'API Android v2 è la stessa dell'app Google Maps sul tuo Android dispositivo. Puoi scoprire di più su Street View e visualizzare le aree supportate su un mappa interattiva, nella sezione Informazioni su Street View.
La classe StreetViewPanorama
modella la strada
Visualizza il panorama nella tua applicazione. Nella UI è rappresentata una panoramica
da un StreetViewPanoramaFragment
o
StreetViewPanoramaView
.
Esempi di codice
Il repository ApiDemos su GitHub include esempi che dimostrano l'uso di Street View.
Esempi di Kotlin:
- StreetViewPanoramaBasicDemoActivity: nozioni di base sull'utilizzo Street View
- StreetViewPanoramaEventsDemoActivity: ascolto di eventi
- StreetViewPanoramaNavigationDemoActivity: controllo Panoramiche di Street View in modo programmatico
- StreetViewPanoramaOptionsDemoActivity: modifica dell'interfaccia utente e opzioni gesto
- StreetViewPanoramaViewDemoActivity: utilizzo della classe
StreetViewPanoramaView
(anziché un Frammento) - SplitStreetViewPanoramaAndMapDemoActivity: utilizzo di un parametro attività che mostra un'immagine Street View e una mappa
Esempi Java:
- StreetViewPanoramaBasicDemoActivity: nozioni di base sull'utilizzo Street View
- StreetViewPanoramaEventsDemoActivity: ascolto di eventi
- StreetViewPanoramaNavigationDemoActivity: controllo Panoramiche di Street View in modo programmatico
- StreetViewPanoramaOptionsDemoActivity: modifica dell'interfaccia utente e opzioni gesto
- StreetViewPanoramaViewDemoActivity: utilizzo della classe
StreetViewPanoramaView
(anziché un Frammento) - SplitStreetViewPanoramaAndMapDemoActivity: creazione di una attività che mostra un'immagine Street View e una mappa
Panoramica di Street View in Maps SDK for Android
Maps SDK for Android fornisce un servizio Street View per ottenere e manipolare le immagini utilizzate in Google Street View. Le immagini vengono restituite come panoramiche.
Ogni panoramica in Street View è un'immagine, o una serie di immagini, che fornisce una Visualizzazione a 360 gradi da un'unica posizione. Le immagini si conformano all'equirettangolare (Plate Carrée), che contiene una vista orizzontale a 360° (avvolgimento completo) e una visuale verticale di 180° (dall'immagine dritta a verso il basso). La panoramica a 360° risultante definisce una proiezione su una sfera con l'immagine posizionata sulla superficie bidimensionale di tale sfera.
StreetViewPanorama
fornisce uno spettatore che esegue il rendering
il panorama sotto forma di sfera con una fotocamera al centro. Puoi modificare
StreetViewPanoramaCamera
per controllare lo zoom e l'orientamento (inclinazione e orientamento) della fotocamera.
Inizia
Configura un progetto
Segui la guida introduttiva per configurare un Progetto Maps SDK for Android.
Verifica la disponibilità di panoramiche in Street View prima di aggiungerne una
La libreria client dell'SDK Google Play Services include alcuni Esempi di Street View che puoi importare nel tuo progetto e da usare come base per lo sviluppo. Consulta l'introduzione a linee guida sull'importazione degli esempi.
La Libreria di utilità di Maps SDK for Android
è una libreria open source di classi utili per una serie
diverse applicazioni. Il repository GitHub include
Utility per i metadati di Street View.
Questa utilità verifica se una località è supportata da
e Street View. Puoi evitare errori quando aggiungi
Panoramica di Street View a un'app Android chiamandola
utilità di metadati e aggiungendo solo una panoramica Street View
se la risposta è OK
.
Utilizzare l'API
Per aggiungere una panoramica di Street View a un dispositivo Android, procedi nel seguente modo. . Questo è il modo più semplice per aggiungere Street View alla tua applicazione. Poi ulteriori informazioni su frammenti, viste e personalizzazione delle panoramiche.
Aggiungi una panoramica di Street View
Per aggiungere una panoramica di Street View come questa:
![Panoramica in Street View Demo panoramica in Street View](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/android-sdk/images/streetview.png?authuser=8&hl=it)
In sintesi:
- Aggiungi un oggetto Fragment all'Attività
che gestirà la panoramica di Street View. Il modo più semplice per farlo è
aggiungi un elemento
<fragment>
al file di layout perActivity
. - Implementa il
OnStreetViewPanoramaReadyCallback
a riga di comando e utilizzareonStreetViewPanoramaReady(StreetViewPanorama)
per ottenere un handleStreetViewPanorama
. - Chiama
getStreetViewPanoramaAsync()
sul per registrare il callback.
Di seguito sono riportati maggiori dettagli su ciascun passaggio.
Aggiungi un frammento
Aggiungi un elemento <fragment>
al file di layout dell'attività per definire un
Oggetto Frammento. In questo elemento, imposta class
a com.google.android.gms.maps.StreetViewPanoramaFragment
(o
SupportStreetViewPanoramaFragment
).
Ecco un esempio di frammento in un file di layout:
<fragment android:name="com.google.android.gms.maps.StreetViewPanoramaFragment" android:id="@+id/streetviewpanorama" android:layout_width="match_parent" android:layout_height="match_parent"/>
Aggiungi il codice Street View
Per utilizzare la panoramica di Street View all'interno della tua app, devi implementare
OnStreetViewPanoramaReadyCallback
e impostare un'istanza del callback su una
StreetViewPanoramaFragment
oppure
StreetViewPanoramaView
. Questo tutorial utilizza un
StreetViewPanoramaFragment
, perché è il modo più semplice per aggiungere immagini di Street View
alla tua app. Il primo passaggio consiste nell'implementare l'interfaccia di callback:
Kotlin
class StreetViewActivity : AppCompatActivity(), OnStreetViewPanoramaReadyCallback { // ... }
Java
class StreetViewActivity extends AppCompatActivity implements OnStreetViewPanoramaReadyCallback { // ... }
Nel onCreate()
del tuo Activity
, imposta il file di layout come visualizzazione dei contenuti. Ad esempio, se il file di layout
ha il nome main.xml
, utilizza questo codice:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_street_view) val streetViewPanoramaFragment = supportFragmentManager .findFragmentById(R.id.street_view_panorama) as SupportStreetViewPanoramaFragment streetViewPanoramaFragment.getStreetViewPanoramaAsync(this) }
Java
@Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_street_view); SupportStreetViewPanoramaFragment streetViewPanoramaFragment = (SupportStreetViewPanoramaFragment) getSupportFragmentManager() .findFragmentById(R.id.street_view_panorama); streetViewPanoramaFragment.getStreetViewPanoramaAsync(this); }
Ottieni un handle per il frammento richiamando
FragmentManager.findFragmentById()
,
passando l'ID risorsa dell'elemento <fragment>
.
Tieni presente che l'ID risorsa R.id.streetviewpanorama
viene aggiunto automaticamente
del progetto Android quando crei il file di layout.
Quindi utilizza getStreetViewPanoramaAsync()
per impostare il callback sul frammento.
Kotlin
val streetViewPanoramaFragment = supportFragmentManager .findFragmentById(R.id.street_view_panorama) as SupportStreetViewPanoramaFragment streetViewPanoramaFragment.getStreetViewPanoramaAsync(this)
Java
SupportStreetViewPanoramaFragment streetViewPanoramaFragment = (SupportStreetViewPanoramaFragment) getSupportFragmentManager() .findFragmentById(R.id.street_view_panorama); streetViewPanoramaFragment.getStreetViewPanoramaAsync(this);
Utilizza la
onStreetViewPanoramaReady(StreetViewPanorama)
per recuperare un'istanza non null di
StreetViewPanorama
, pronto per l'uso.
Kotlin
override fun onStreetViewPanoramaReady(streetViewPanorama: StreetViewPanorama) { val sanFrancisco = LatLng(37.754130, -122.447129) streetViewPanorama.setPosition(sanFrancisco) }
Java
@Override public void onStreetViewPanoramaReady(StreetViewPanorama streetViewPanorama) { LatLng sanFrancisco = new LatLng(37.754130, -122.447129); streetViewPanorama.setPosition(sanFrancisco); }
Scopri di più sulla configurazione dello stato iniziale
A differenza di una mappa, non è possibile configurare lo stato iniziale
Panoramica di Street View tramite XML. Tuttavia, puoi configurare
il panorama in modo programmatico, passando
Oggetto StreetViewPanoramaOptions
contenente le opzioni specificate.
- Se usi
StreetViewPanoramaFragment
, usaStreetViewPanoramaFragment.newInstance(StreetViewPanoramaOptions options)
il metodo di fabbrica statico per creare il frammento e passare il codice le opzioni configurate. - Se usi
StreetViewPanoramaView
, usaStreetViewPanoramaView(Context, StreetViewPanoramaOptions)
e trasferire le opzioni configurate personalizzate.
Kotlin
val sanFrancisco = LatLng(37.754130, -122.447129) val view = StreetViewPanoramaView( this, StreetViewPanoramaOptions().position(sanFrancisco) )
Java
LatLng sanFrancisco = new LatLng(37.754130, -122.447129); StreetViewPanoramaView view = new StreetViewPanoramaView(this, new StreetViewPanoramaOptions().position(sanFrancisco));
Scopri di più su StreetViewPanoramaFragment
StreetViewPanoramaFragment
è una sottoclasse del
Android Fragment e ti consente di inserire un
panoramica in un frammento Android. StreetViewPanoramaFragment
di oggetti agiscono come
contenitori per la panoramica e fornire accesso all'oggetto StreetViewPanorama
.
StreetViewPanoramaView
StreetViewPanoramaView
, una sottoclasse del modello
View
, ti consente di inserire un'immagine di Street View
panoramica in un Android View
. View
rappresenta una regione rettangolare
schermo ed è un componente di base fondamentale per i widget e le app Android.
Proprio come un StreetViewPanoramaFragment
, il StreetViewPanoramaView
agisce
un container per la panoramica, che espone le funzionalità di base attraverso
StreetViewPanorama
oggetto. Gli utenti di questo corso devono inoltrare tutte le attività
metodi del ciclo di vita (come onCreate()
, onDestroy()
, onResume()
e
onPause())
ai metodi corrispondenti nella classe StreetViewPanoramaView
.
Personalizza la funzionalità controllata dall'utente
Per impostazione predefinita, l'utente ha a disposizione le seguenti funzionalità durante la visualizzazione
Panoramica di Street View: panoramica, zoom e spostamento
alle panoramiche adiacenti. Puoi attivare e disattivare i gesti controllati dall'utente
tramite metodi su StreetViewPanorama
. Programmatici
sono comunque possibili anche quando il gesto è disattivato.
Impostare la posizione del panorama
Per impostare la posizione della panoramica in Street View, chiama il numero
StreetViewPanorama.setPosition()
, superando un LatLng
.
Puoi anche trasmettere radius
e source
come parametri facoltativi.
Il raggio è utile per ampliare o
restringi l'area in cui Street View cercherà una panoramica corrispondente. Un raggio
0 indica che la panoramica deve essere collegata esattamente al valore LatLng
specificato.
Il raggio predefinito è 50 metri. Se è presente più di una panoramica nella
l'area corrispondente, l'API restituirà la corrispondenza migliore.
Una sorgente è utile se vuoi limitare Street View a Cercare solo panoramiche all'aperto. Per impostazione predefinita, Street View i panorami potrebbero essere all'interno di luoghi quali musei, edifici pubblici, bar e attività commerciali. Tieni presente che le panoramiche di esterni potrebbero non esistere per la posizione specificata.
Kotlin
val sanFrancisco = LatLng(37.754130, -122.447129) // Set position with LatLng only. streetViewPanorama.setPosition(sanFrancisco) // Set position with LatLng and radius. streetViewPanorama.setPosition(sanFrancisco, 20) // Set position with LatLng and source. streetViewPanorama.setPosition(sanFrancisco, StreetViewSource.OUTDOOR) // Set position with LaLng, radius and source. streetViewPanorama.setPosition(sanFrancisco, 20, StreetViewSource.OUTDOOR)
Java
LatLng sanFrancisco = new LatLng(37.754130, -122.447129); // Set position with LatLng only. streetViewPanorama.setPosition(sanFrancisco); // Set position with LatLng and radius. streetViewPanorama.setPosition(sanFrancisco, 20); // Set position with LatLng and source. streetViewPanorama.setPosition(sanFrancisco, StreetViewSource.OUTDOOR); // Set position with LaLng, radius and source. streetViewPanorama.setPosition(sanFrancisco, 20, StreetViewSource.OUTDOOR);
In alternativa, puoi impostare la posizione in base all'ID di una panoramica trasmettendo un
Da panoId
a StreetViewPanorama.setPosition()
.
Per recuperare l'ID delle panoramiche adiacenti, utilizza innanzitutto
getLocation()
per recuperare un StreetViewPanoramaLocation
.
Questo oggetto contiene l'ID
panoramica corrente e un array di StreetViewPanoramaLink
oggetti, ciascuno
di cui contiene l'ID di una panoramica collegata a quella corrente.
Kotlin
streetViewPanorama.location.links.firstOrNull()?.let { link: StreetViewPanoramaLink - > streetViewPanorama.setPosition(link.panoId) }
Java
StreetViewPanoramaLocation location = streetViewPanorama.getLocation(); if (location != null &&location.links != null) { streetViewPanorama.setPosition(location.links[0].panoId); }
Zoom avanti e indietro
Puoi modificare il livello di zoom in modo programmatico impostando
StreetViewPanoramaCamera.zoom
Impostando lo zoom su 1,0, l'immagine verrà ingrandita.
di un fattore 2.
Il seguente snippet utilizza StreetViewPanoramaCamera.Builder()
per creare un
nuova videocamera con l'inclinazione e l'orientamento di quella esistente, aumentando al contempo
lo zoom del cinquanta percento.
Kotlin
val zoomBy = 0.5f val camera = StreetViewPanoramaCamera.Builder() .zoom(streetViewPanorama.panoramaCamera.zoom + zoomBy) .tilt(streetViewPanorama.panoramaCamera.tilt) .bearing(streetViewPanorama.panoramaCamera.bearing) .build()
Java
float zoomBy = 0.5f; StreetViewPanoramaCamera camera = new StreetViewPanoramaCamera.Builder() .zoom(streetViewPanorama.getPanoramaCamera().zoom + zoomBy) .tilt(streetViewPanorama.getPanoramaCamera().tilt) .bearing(streetViewPanorama.getPanoramaCamera().bearing) .build();
Impostare l'orientamento della fotocamera (punto di vista)
Puoi determinare l'orientamento della fotocamera di Street View impostando la
orientamento e inclinazione su StreetViewPanoramaCamera
.
- bearing
- La direzione in cui è rivolta la fotocamera, specificata in gradi in senso orario dal vero nord, intorno al locus della fotocamera. Il vero nord è 0, l'est è 90, il sud è 180, l'ovest è 270.
- inclinazione
- L'asse Y si inclina verso l'alto o verso il basso. L'intervallo va da -90 a 0 e 90, con -90 con lo sguardo rivolto verso il basso, 0 centrato sull'orizzonte e 90 rivolto in linea retta verso l'alto. La varianza viene misurata in base al tono predefinito iniziale della videocamera, che è spesso (ma non sempre) piatto orizzontale. Ad esempio, un'immagine scattata su un hill avrà probabilmente un'inclinazione predefinita non orizzontale.
Il seguente snippet utilizza StreetViewPanoramaCamera.Builder()
per creare un
nuova videocamera con lo zoom e l'inclinazione di quella esistente, mentre modifichi
di 30 gradi a sinistra.
Kotlin
val panBy = 30f val camera = StreetViewPanoramaCamera.Builder() .zoom(streetViewPanorama.panoramaCamera.zoom) .tilt(streetViewPanorama.panoramaCamera.tilt) .bearing(streetViewPanorama.panoramaCamera.bearing - panBy) .build()
Java
float panBy = 30; StreetViewPanoramaCamera camera = new StreetViewPanoramaCamera.Builder() .zoom(streetViewPanorama.getPanoramaCamera().zoom) .tilt(streetViewPanorama.getPanoramaCamera().tilt) .bearing(streetViewPanorama.getPanoramaCamera().bearing - panBy) .build();
Il seguente snippet inclina la fotocamera verso l'alto di 30 gradi.
Kotlin
var tilt = streetViewPanorama.panoramaCamera.tilt + 30 tilt = if (tilt 9>0) 90f else tilt val previous = streetViewPanorama.panoramaCamera val camera = StreetViewPanoramaCamera.Builder(previous) .tilt(tilt) .build()
Java
float tilt = streetViewPanorama.getPanoramaCamera().tilt + 30; tilt = (tilt >90) ? 90 : tilt; StreetViewPanoramaCamera previous = streetViewPanorama.getPanoramaCamera(); StreetViewPanoramaCamera camera = new StreetViewPanoramaCamera.Builder(previous) .tilt(tilt) .build();
Anima i movimenti della videocamera
Per animare i movimenti della fotocamera, richiama
StreetViewPanorama.animateTo()
L'animazione si interpola tra gli attributi correnti della videocamera e i nuovi.
degli attributi fotocamera. Se vuoi passare direttamente alla
videocamera senza animazione,
puoi impostare la durata su 0.
Kotlin
// Keeping the zoom and tilt. Animate bearing by 60 degrees in 1000 milliseconds. val duration: Long = 1000 val camera = StreetViewPanoramaCamera.Builder() .zoom(streetViewPanorama.panoramaCamera.zoom) .tilt(streetViewPanorama.panoramaCamera.tilt) .bearing(streetViewPanorama.panoramaCamera.bearing - 60) .build() streetViewPanorama.animateTo(camera, duration)
Java
// Keeping the zoom and tilt. Animate bearing by 60 degrees in 1000 milliseconds. long duration = 1000; StreetViewPanoramaCamera camera = new StreetViewPanoramaCamera.Builder() .zoom(streetViewPanorama.getPanoramaCamera().zoom) .tilt(streetViewPanorama.getPanoramaCamera().tilt) .bearing(streetViewPanorama.getPanoramaCamera().bearing - 60) .build(); streetViewPanorama.animateTo(camera, duration);
L'immagine seguente mostra il risultato quando pianifichi l'esecuzione dell'animazione di cui sopra
ogni 2000 millisecondi, utilizzando Handler.postDelayed()
:
![Animazione panoramica in Street View Demo dell'animazione panoramica in Street View](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/android-sdk/images/streetview_anim.gif?authuser=8&hl=it)