Configura una mappa

Seleziona la piattaforma: Android iOS

Per seguire un viaggio nella tua app consumer, devi prima definire una mappa e aggiungere il supporto per le mappe vettoriali, se necessario.

Per impostare una mappa nella tua app, segui questi passaggi:

  1. Definisci un frammento di mappa per seguire un viaggio.
  2. Aggiungi supporto per un livello base di mappe e un controller di visualizzazione.
  3. Aggiungi il supporto per la grafica vettoriale Android per visualizzare mappe vettoriali, se necessario.

Dopo aver definito una mappa, puoi aggiungere altre viste e controlli della telecamera per personalizzare l'esperienza visiva. Per maggiori dettagli, consulta Assegnare uno stile a una mappa.

Fase 1: definire un frammento di mappa per seguire un viaggio

Per definire una mappa, aggiungi un frammento o una vista per creare la mappa in cui condividere un viaggio on-demand nella tua app consumer. Per definire la mappa, segui uno di questi metodi:

  • ConsumerMapFragment: utilizza questa proprietà per definire la mappa con un Fragment.

  • ConsumerMapView: utilizzare per definire una mappa con un View.

Le caratteristiche sono le stesse per entrambi i metodi, quindi scegli quello più adatto alla tua applicazione.

Entrambi i metodi sono spiegati in modo più dettagliato nella sezione seguente.

Aggiungi un frammento o una vista della mappa

Per creare una mappa che visualizzi l'avanzamento del viaggio utilizzando un frammento Android o una vista, segui questi passaggi e fai riferimento agli esempi di codice.

  1. Definisci un frammento o una vista nel file XML del layout dell'applicazione situato in /res/layout. Definisci la mappa del viaggio come un frammento utilizzando ConsumerMapFragment oppure come una vista utilizzando ConsumerMapView.

    Il frammento o la vista forniscono quindi l'accesso alla mappa del viaggio, a cui la tua app può accedere e che può modificare. La mappa fornisce anche un handle per ConsumerController, che consente alla tua app di controllare e personalizzare l'esperienza del consumatore.

  2. Dal metodo onCreate(), chiama getConsumerGoogleMapAsync(callback), che restituisce ConsumerGoogleMap in modo asincrono nella callback.

  3. Utilizza ConsumerGoogleMap per visualizzare l'avanzamento del viaggio e aggiornarlo se necessario.

Esempio di come aggiungere ConsumerMapFragment

  1. Definisci il fragment nel file XML di layout dell'applicazione, come mostrato nell'esempio di codice seguente.

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

  2. Effettua una chiamata a getConsumerGoogleMapAsync() dal metodo onCreate().

Java

 public class SampleAppActivity extends AppCompatActivity {

   @Override
   protected void onCreate(Bundle savedInstanceState) {

     // Find the ConsumerMapFragment.
     ConsumerMapFragment consumerMapFragment =
         (ConsumerMapFragment) fragmentManager.findFragmentById(R.id.consumer_map_fragment);

     // Initiate the callback that returns the map.
     if (consumerMapFragment != null) {
       consumerMapFragment.getConsumerGoogleMapAsync(
           new ConsumerMapReadyCallback() {
             // The map returned in the callback is used to access the ConsumerController.
             @Override
             public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
               ConsumerController consumerController = consumerGoogleMap.getConsumerController();
             }
           });
     }
   }

 }

Kotlin

 class SampleAppActivity : AppCompatActivity() {
   override fun onCreate(savedInstanceState: Bundle?) {
     // Find the ConsumerMapFragment.
     val consumerMapFragment =
       fragmentManager.findFragmentById(R.id.consumer_map_fragment) as ConsumerMapFragment

     consumerMapFragment.getConsumerGoogleMapAsync(
       object : ConsumerMapReadyCallback() {
         override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
           val consumerController = consumerGoogleMap.getConsumerController()!!
         }
       }
     )
   }
 }

Esempio di come aggiungere ConsumerMapView

  1. Utilizza la visualizzazione in un frammento o in un'attività, come definito nel file XML.

     <com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapView
     xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/consumer_map_view"
     android:layout_width="match_parent"
     android:layout_height="match_parent" />

  2. Effettua la chiamata a getConsumerGoogleMapAsync() da onCreate(). Oltre al parametro di callback, includi i seguenti dettagli:

    • L'attività o il fragment contenitore. La classe base dell'attività o del fragment deve essere FragmentActivity o Fragment (rispettivamente), poiché forniscono l'accesso al suo ciclo di vita.

    • GoogleMapOptions (che può essere null), contenente gli attributi di configurazione per MapView.

Java

public class SampleAppActivity extends AppCompatActivity {

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

    if (mapView != null) {
      mapView.getConsumerGoogleMapAsync(
          new ConsumerMapReadyCallback() {
            // The map returned in the callback is used to access the ConsumerController.
            @Override
            public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
              ConsumerController consumerController = consumerGoogleMap.getConsumerController();
            }
          }, this, null);
    }
  }

}

Kotlin

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

    mapView.getConsumerGoogleMapAsync(
      object : ConsumerMapReadyCallback() {
        // The map returned in the callback is used to access the ConsumerController.
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          val consumerController = consumerGoogleMap.getConsumerController()!!
        }
      },
      /* fragmentActivity= */ this,
      /* googleMapOptions= */ null,
    )
  }
}

Un MapView in un frammento è uguale a quello dell'esempio precedente per MapView in un'attività, tranne per il fatto che il frammento gonfia il layout che include MapView nel metodo onCreateView() del frammento.

Java

public class MapViewInFragment extends Fragment {

  @Override
  public View onCreateView(
      @NonNull LayoutInflater layoutInflater,
      @Nullable ViewGroup viewGroup,
      @Nullable Bundle bundle) {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false);
  }

}

Kotlin

class MapViewInFragment : Fragment() {
  override fun onCreateView(
    layoutInflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?,
  ): View {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false)
  }
}

Passaggio 2: aggiungi il supporto per un livello di base e un controller di visualizzazione delle mappe

Per condividere l'avanzamento del viaggio nella tua app, aggiungi le seguenti classi alla tua app: ConsumerGoogleMap e ConsumerController.

  • Recupera ConsumerGoogleMap da ConsumerMapFragment o ConsumerMapView, entrambi restituiscono in modo asincrono ConsumerGoogleMap in ConsumerMapReadyCallback.

    ConsumerGoogleMap è una classe wrapper per la classe GoogleMap. Utilizza un'API equivalente a GoogleMap in modo che la tua app possa interagire con la mappa. In questo modo, la tua app può interagire senza problemi con la stessa mappa di Google sottostante. Ad esempio, GoogleMap consente una sola registrazione di callback, mentre ConsumerGoogleMap supporta i callback registrati doppi. Questi callback consentono alla tua app di registrare callback chiamati in sequenza.

  • Ricevi ConsumerController da ConsumerGoogleMap in getConsumerController().

    ConsumerController fornisce l'accesso alle funzionalità di condivisione dei viaggi, ad esempio monitorare i viaggi, controllare lo stato dei viaggi e impostare le posizioni.

Per scoprire come aggiungere ConsumerGoogleMap e ConsumerController alla tua app in Java e Kotlin, consulta gli esempi riportati di seguito.

Java

private ConsumerGoogleMap consumerGoogleMap;
private ConsumerController consumerController;
private ConsumerMapView consumerMapView;

consumerMapView.getConsumerGoogleMapAsync(
    new ConsumerMapReadyCallback() {
      @Override
      public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerMap) {
        consumerGoogleMap = consumerMap;
        consumerController = consumerMap.getConsumerController();
      }
    },
    this, null);

Kotlin

var consumerGoogleMap: ConsumerGoogleMap
var consumerController: ConsumerController
val consumerMapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

consumerMapView.getConsumerGoogleMapAsync(
  object : ConsumerMapReadyCallback() {
    override fun onConsumerMapReady(consumerMap: ConsumerGoogleMap) {
      consumerGoogleMap = consumerMap
      consumerController = consumerMap.getConsumerController()
    },
    /* fragmentActivity= */ this,
    /* googleMapOptions= */ null,
  }
)

Passaggio 3: aggiungi il supporto per la grafica vettoriale Android

Se il design della tua app richiede il supporto della grafica vettoriale, aggiungi il supporto per i dispositivi Android e i drawables vettoriali seguendo questi passaggi:

  1. Aggiungi il seguente codice all'attività. Questo codice estende AppCompatActivity per utilizzare i drawables vettoriali nell'SDK Consumer.

Java

// ...
import android.support.v7.app.AppCompatActivity;

// ...

public class ConsumerTestActivity extends AppCompatActivity {
  // ...
}

Kotlin

// ...
import android.support.v7.app.AppCompatActivity

// ...

class ConsumerTestActivity : AppCompatActivity() {
  // ...
}

Passaggi successivi

Seguire un viaggio su Android

Applicare uno stile a una mappa