Definizione di una mappa

Seleziona la piattaforma: Android iOS JavaScript

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

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

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

Entrambi i campi ConsumerMapView e ai ConsumerMapFragment supportano la personalizzazione delle mappe basata su cloud. Per utilizzare la personalizzazione delle mappe basata su cloud, assicurati che il visualizzatore delle mappe selezionato sia LATEST. Le seguenti sezioni mostrano esempi di utilizzo la personalizzazione delle mappe basata su cloud con il tuo progetto.

ConsumerMapView

Per utilizzare la Personalizzazione delle mappe basata su cloud in ConsumerMapView, imposta la campo mapId su GoogleMapOptions e passa il GoogleMapOptions a getConsumerGoogleMapAsync(ConsumerMapReadyCallback, Fragment, GoogleMapOptions) oppure 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 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 file XML nel ConsumerMapFragment, aggiungi l'attributo XML map:mapId con il valore specificato 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 supera il Da 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
  }
}

Regola lo zoom della fotocamera per mettere a fuoco un percorso

Durante una sessione di condivisione attiva del percorso, puoi gestire lo zoom e possono essere concentrati in uno di questi due modi:

  • AutoCamera: se vuoi utilizzare AutoCamera, non hai fare qualsiasi cosa. La fotocamera segue il percorso. Per maggiori dettagli, vedi AutoCamera

  • Personalizza il comportamento della videocamera: per personalizzare il comportamento della videocamera, devi disattivare AutoCamera e poi apportare 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 aumenta lo zoom fino a concentrarsi sul percorso di condivisione del viaggio e sulla tappa successiva del viaggio.

Se vuoi utilizzare AutoCamera, assicurati di attivarlo. Per ulteriori dettagli, vedi isAutoCameraEnabled

&quot;Fotocamera automatica&quot;

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

Personalizzare il comportamento della videocamera

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

  1. Disattiva AutoCamera utilizzando ConsumerController.setAutoCameraEnabled().

  2. Recuperare i limiti consigliati per la fotocamera utilizzando ConsumerController.getCameraUpdate().

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

Passaggi successivi

Seguire un viaggio in Android