Configurer une carte

Sélectionnez une plate-forme : Android iOS

Pour suivre un trajet dans votre application grand public, vous devez d'abord définir une carte et ajouter la prise en charge des cartes vectorielles, si nécessaire.

Pour configurer une carte dans votre application, procédez comme suit :

  1. Définissez un fragment de carte pour suivre un trajet.
  2. Ajoutez la prise en charge d'un calque de base de carte et d'un contrôleur de vue.
  3. Si nécessaire, ajoutez la prise en charge des graphiques vectoriels Android pour afficher les cartes vectorielles.

Une fois que vous avez défini une carte, vous pouvez ajouter des vues et des commandes de caméra supplémentaires pour personnaliser l'expérience visuelle. Pour en savoir plus, consultez Appliquer un style à une carte.

Étape 1 : Définissez un fragment de carte pour suivre un trajet

Vous définissez une carte en ajoutant un fragment ou une vue de carte pour créer la carte sur laquelle vous partagez un trajet à la demande dans votre application grand public. Pour définir votre carte, suivez l'une des méthodes suivantes :

  • ConsumerMapFragment : utilisez-le pour définir votre carte avec un Fragment.

  • ConsumerMapView : permet de définir une carte avec un View.

Les fonctionnalités sont les mêmes pour les deux méthodes. Choisissez donc celle qui convient le mieux à votre application.

Les deux méthodes sont expliquées plus en détail dans la section suivante.

Ajouter un fragment ou une vue de carte

Pour créer une carte permettant d'afficher la progression du trajet à l'aide d'un fragment ou d'une vue Android, suivez ces étapes et reportez-vous aux exemples de code.

  1. Définissez un fragment ou une vue dans le fichier XML de mise en page de votre application situé dans /res/layout. Définissez la carte du trajet comme un fragment à l'aide de ConsumerMapFragment ou comme une vue à l'aide de ConsumerMapView.

    Le fragment ou la vue permettent ensuite d'accéder à la carte de trajet que votre application peut consulter et modifier. La carte fournit également un handle pour ConsumerController, ce qui permet à votre application de contrôler et de personnaliser l'expérience utilisateur.

  2. À partir de votre méthode onCreate(), appelez getConsumerGoogleMapAsync(callback), qui renvoie ConsumerGoogleMap de manière asynchrone dans le rappel.

  3. Utilisez ConsumerGoogleMap pour afficher la progression du trajet et la mettre à jour si nécessaire.

Exemple d'ajout de ConsumerMapFragment

  1. Définissez le fragment dans le fichier XML de mise en page de votre application, comme indiqué dans l'exemple de code suivant.

    <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. Appelez getConsumerGoogleMapAsync() à partir de la méthode 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()!!
         }
       }
     )
   }
 }

Exemple d'ajout de ConsumerMapView

  1. Utilisez la vue dans un fragment ou dans une activité, comme défini dans votre fichier 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. Appelez getConsumerGoogleMapAsync() depuis onCreate(). En plus du paramètre de rappel, incluez les informations suivantes :

    • Activité ou fragment contenant. La classe de base de l'activité ou du fragment doit être FragmentActivity ou Fragment (respectivement), car elles permettent d'accéder à son cycle de vie.

    • GoogleMapOptions (qui peut être nul), contenant les attributs de configuration pour 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 dans un fragment est identique à celui de l'exemple précédent pour MapView dans une activité, sauf que le fragment augmente la mise en page qui inclut le MapView dans la méthode onCreateView() du fragment.

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)
  }
}

Étape 2 : Ajoutez la prise en charge d'un calque de base et d'un contrôleur de vue Maps

Pour partager la progression du trajet dans votre application, ajoutez les classes suivantes : ConsumerGoogleMap et ConsumerController.

  • Obtenez ConsumerGoogleMap à partir de ConsumerMapFragment ou ConsumerMapView, qui renvoient tous deux ConsumerGoogleMap de manière asynchrone dans ConsumerMapReadyCallback.

    ConsumerGoogleMap est une classe wrapper pour la classe GoogleMap. Il utilise une API équivalente à GoogleMap pour que votre application puisse interagir avec la carte. Votre application peut ainsi interagir de manière fluide avec la même carte Google sous-jacente. Par exemple, GoogleMap n'autorise qu'un seul enregistrement de rappel, tandis que ConsumerGoogleMap accepte deux rappels enregistrés. Ces rappels permettent à votre application d'enregistrer des rappels qui sont appelés séquentiellement.

  • Obtenez ConsumerController auprès de ConsumerGoogleMap dans getConsumerController().

    ConsumerController permet d'accéder aux fonctionnalités de partage de trajets, comme la surveillance des trajets, le contrôle de leur état et la définition de lieux.

Pour savoir comment ajouter ConsumerGoogleMap et ConsumerController à votre application en Java et Kotlin, consultez les exemples suivants.

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,
  }
)

Étape 3 : Ajoutez la prise en charge des graphiques vectoriels Android

Si la conception de votre application nécessite la prise en charge des graphiques vectoriels, ajoutez la prise en charge des appareils Android et des drawables vectoriels en procédant comme suit :

  1. Ajoutez le code suivant à votre activité. Ce code étend AppCompatActivity pour utiliser les drawables vectoriels dans le SDK Consumer.

Java

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

// ...

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

Kotlin

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

// ...

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

Étape suivante

Suivre un trajet sur Android

Appliquer un style à une carte