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 per Android quando segui un viaggio. Puoi personalizzare l'aspetto della mappa nei seguenti modi:

Personalizzare la mappa con la personalizzazione delle mappe basata su cloud

Personalizza l'aspetto del componente mappe utilizzando la personalizzazione delle mappe basata su cloud. Puoi creare e modificare gli stili delle mappe nella console Google Cloud per qualsiasi app che utilizza Google Maps, senza richiedere modifiche al codice. Per ulteriori informazioni, seleziona la tua piattaforma in Personalizzazione delle mappe basata su cloud.

Sia la ConsumerMapView sia la ConsumerMapFragment classi supportano la personalizzazione delle mappe basata su cloud. Per utilizzare la personalizzazione delle mappe basata su cloud, assicurati che il renderer delle mappe selezionato sia LATEST. Le sezioni che seguono mostrano esempi di come utilizzare la personalizzazione delle mappe basata su cloud con il tuo progetto.

ConsumerMapView

Per utilizzare la personalizzazione delle mappe basata su cloud in ConsumerMapView, imposta il mapId campo su GoogleMapOptions e passa il 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

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

  • Staticamente con il file XML.
  • Dinamicamente con newInstance.

Staticamente con il file XML

Per utilizzare la personalizzazione delle mappe basata su cloud con il file XML in the ConsumerMapFragment, aggiungi l'attributo XML map:mapId con the specified mapId. Vedi il seguente esempio:

<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"/>

Dinamicamente con newInstance

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

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 videocamera in modo che si concentri su un viaggio

Durante una sessione di condivisione del viaggio attiva, puoi gestire lo zoom e la messa a fuoco della videocamera in due modi:

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

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

AutoCamera centra la videocamera

Consumer SDK fornisce una funzionalità AutoCamera che è attivata per impostazione predefinita sul pulsante La mia posizione integrato per Maps SDK. La videocamera esegue lo zoom per concentrarsi sul percorso del viaggio e sul waypoint del viaggio successivo.

Se vuoi utilizzare AutoCamera, assicurati di attivarla. Per maggiori dettagli, vedi isAutoCameraEnabled.

`AutoCamera`

Per informazioni dettagliate sul pulsante La mia posizione, consulta Pulsante La mia posizione nella documentazione dell'API Maps JavaScript.

Personalizzare il comportamento della videocamera

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

  1. Disattiva AutoCamera utilizzando ConsumerController.setAutoCameraEnabled().

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

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

Passaggi successivi

Seguire un viaggio su Android