Definizione di una mappa

Seleziona la piattaforma: Android iOS JavaScript

Questa guida descrive i modi in cui puoi personalizzare la mappa visualizzata nella tua app Android quando segui un viaggio. Puoi personalizzare l'aspetto della mappa nei seguenti modi:

Applica uno stile alla mappa utilizzando la Personalizzazione delle mappe basata su cloud

Personalizza l'aspetto del componente Maps utilizzando la personalizzazione delle mappe basata su cloud. Puoi creare e modificare gli stili delle mappe nella console Google Cloud per qualsiasi delle tue app che utilizzano Google Maps, senza richiedere alcuna modifica al codice. Per ulteriori informazioni, consulta la sezione Personalizzazione delle mappe basata su cloud.

Sia la classe ConsumerMapView che la classe ConsumerMapFragment supportano la personalizzazione delle mappe basata su cloud. Per utilizzare la Personalizzazione delle mappe basata su cloud, assicurati che il renderingr delle mappe selezionato sia LATEST. Le sezioni che seguono mostrano esempi di come utilizzare lo stile delle mappe basate su cloud con il tuo progetto.

ConsumerMapView

Per utilizzare lo stile delle mappe basato su cloud in ConsumerMapView, imposta il campo mapId su GoogleMapOptions e passa GoogleMapOptions a getConsumerGoogleMapAsync(ConsumerMapReadyCallback, Fragment, GoogleMapOptions) o getConsumerGoogleMapAsync(ConsumerMapReadyCallback, FragmentActivity, GoogleMapOptions)

Esempio

Java

public class SampleAppActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ConsumerMapView mapView = findViewById(R.id.consumer_map_view);

    if (mapView != null) {
      GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
      mapView.getConsumerGoogleMapAsync(
          new ConsumerMapReadyCallback() {
            @Override
            public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
              // ...
            }
          },
          /* fragmentActivity= */ this,
          /* googleMapOptions= */ optionsWithMapId);
    }
  }
}

Kotlin

class SampleAppActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

    val optionsWithMapId = GoogleMapOptions().mapId("map-id")
    mapView.getConsumerGoogleMapAsync(
      object : ConsumerGoogleMap.ConsumerMapReadyCallback() {
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          // ...
        }
      },
      /* fragmentActivity= */ this,
      /* googleMapOptions= */ optionsWithMapId)
  }
}

ConsumerMapFragment

Ci sono due modi per utilizzare la personalizzazione delle mappe basata su cloud in ConsumerMapFragments:

  • In modo statico con il file XML.
  • In modo dinamico con newInstance.

In modo statico con il file XML

Per utilizzare la personalizzazione delle mappe basata su cloud con il codice XML in ConsumerMapFragment, aggiungi l'attributo XML map:mapId con il valore mapId specificato. Vedi l'esempio di seguito:

<fragment
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
    android:id="@+id/consumer_map_fragment"
    map:mapId="map-id"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

In modo dinamico con newInstance

Per utilizzare la personalizzazione delle mappe basata su cloud con newInstance in ConsumerMapFragment, imposta il campo mapId su GoogleMapOptions e passa il GoogleMapOptions a newInstance. Vedi l'esempio di seguito:

Java

public class SampleFragmentJ extends Fragment {

  @Override
  public View onCreateView(
      @NonNull LayoutInflater inflater,
      @Nullable ViewGroup container,
      @Nullable Bundle savedInstanceState) {

    final View view = inflater.inflate(R.layout.consumer_map_fragment, container, false);

    GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
    ConsumerMapFragment consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId);

    getParentFragmentManager()
        .beginTransaction()
        .add(R.id.consumer_map_fragment, consumerMapFragment)
        .commit();

    consumerMapFragment.getConsumerGoogleMapAsync(
        new ConsumerMapReadyCallback() {
          @Override
          public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
            // ...
          }
        });

    return view;
  }
}

Kotlin

class SampleFragment : Fragment() {
  override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?): View? {

    val view = inflater.inflate(R.layout.consumer_map_fragment, container, false)

    val optionsWithMapId = GoogleMapOptions().mapId("map-id")
    val consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId)

    parentFragmentManager
      .beginTransaction()
      .add(R.id.consumer_map_fragment, consumerMapFragment)
      .commit()

    consumerMapFragment.getConsumerGoogleMapAsync(
      object : ConsumerMapReadyCallback() {
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          // ...
        }
      })

    return view
  }
}

Regolare lo zoom della fotocamera per mettere a fuoco un viaggio

Durante una sessione di condivisione del percorso attiva, puoi gestire lo zoom e la messa a fuoco della fotocamera in uno dei due modi seguenti:

  • AutoCamera: se vuoi utilizzare AutoCamera, non devi fare nulla. La videocamera segue il viaggio. Per maggiori dettagli, vedi AutoCamera.

  • Personalizza il comportamento della videocamera: per personalizzare il comportamento della videocamera, devi disattivare AutoCamera e poi effettuare le personalizzazioni. Per maggiori dettagli, consulta Personalizzare il comportamento della videocamera.

AutoCamera centra la fotocamera

L'SDK consumer fornisce una funzionalità AutoCamera attivata per impostazione predefinita sul pulsante La mia posizione integrato per Maps SDK. La fotocamera esegue lo zoom per mettere a fuoco il percorso del viaggio e la tappa successiva.

Se vuoi utilizzare AutoCamera, assicurati di abilitarlo. Per maggiori dettagli, consulta isAutoCameraEnabled.

&quot;Fotocamera automatica&quot;

Per maggiori dettagli sul pulsante La mia posizione, consulta la sezione Pulsante La mia posizione nella documentazione dell'API Maps JavaScript.

Personalizza il comportamento della videocamera

Per un maggiore controllo sul comportamento della videocamera, segui questi passaggi per disattivare AutoCamera e personalizzare il comportamento della videocamera manualmente.

  1. Disattiva AutoCamera utilizzando ConsumerController.setAutoCameraEnabled().

  2. Ottieni i limiti consigliati della videocamera utilizzando ConsumerController.getCameraUpdate().

  3. Fornisci CameraUpdate come argomento a una di queste funzioni Android:

Passaggi successivi

Seguire un viaggio in Android