Configurar un mapa

Selecciona la plataforma: Android iOS

Para seguir un viaje en tu app para consumidores, primero debes definir un mapa y agregar compatibilidad con mapas vectoriales, si es necesario.

Para configurar un mapa en tu app, sigue estos pasos:

  1. Define un fragmento de mapa para seguir un viaje.
  2. Se agregó compatibilidad con una capa base de mapas y un controlador de vista.
  3. Agrega compatibilidad con gráficos vectoriales de Android para mostrar mapas vectoriales, si es necesario.

Después de definir un mapa, puedes agregar vistas y controles de cámara adicionales que quieras para personalizar la experiencia visual. Para obtener más detalles, consulta Cómo aplicar diseño a un mapa.

Paso 1: Define un fragmento de mapa para seguir un viaje

Para definir un mapa, agrega un fragmento o una vista de mapa para crear el mapa en el que compartes un viaje a pedido en tu app para consumidores. Para definir tu mapa, sigue uno de estos métodos:

  • ConsumerMapFragment: Úsalo para definir tu mapa con un Fragment.

  • ConsumerMapView: Úsalo para definir un mapa con un View.

Las funciones son las mismas para ambos métodos, así que elige cuál es mejor para tu aplicación.

Ambos métodos se explican con más detalle en la siguiente sección.

Cómo agregar un fragmento o una vista de mapa

Para crear un mapa que muestre el progreso del viaje con un fragmento de Android o una vista, sigue estos pasos y consulta los ejemplos de código.

  1. Define un fragmento o una vista en el archivo en formato XML de diseño de tu aplicación que se encuentra en /res/layout. Define el mapa de viaje como un fragmento con ConsumerMapFragment o como una vista con ConsumerMapView.

    Luego, el fragmento o la vista proporciona acceso al mapa de viaje al que tu app puede acceder y modificar. El mapa también proporciona un control a ConsumerController, lo que permite que tu app controle y personalice la experiencia del consumidor.

  2. Desde tu método onCreate(), llama a getConsumerGoogleMapAsync(callback), que muestra ConsumerGoogleMap de forma asíncrona en la devolución de llamada.

  3. Usa ConsumerGoogleMap para mostrar el progreso del viaje y actualizarlo según sea necesario.

Ejemplo de cómo agregar ConsumerMapFragment

  1. Define el fragmento en el archivo en formato XML de diseño de tu aplicación, como se muestra en el siguiente ejemplo de código.

    <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. Realiza una llamada a getConsumerGoogleMapAsync() desde el método 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()!!
         }
       }
     )
   }
 }

Ejemplo de cómo agregar ConsumerMapView

  1. Usa la vista en un fragmento o en una actividad, como se define en tu archivo en formato 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. Realiza la llamada a getConsumerGoogleMapAsync() desde onCreate(). Además del parámetro de devolución de llamada, incluye los siguientes detalles:

    • La actividad o el fragmento que lo contiene. La clase base de la actividad o el fragmento debe ser FragmentActivity o Fragment de compatibilidad (respectivamente), ya que proporcionan acceso a su ciclo de vida.

    • GoogleMapOptions (que puede ser nulo), que contiene atributos de configuración para 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 en un fragmento es igual que en el ejemplo anterior para MapView en una actividad, excepto que el fragmento aumenta el diseño que incluye el MapView en el método onCreateView() del fragmento.

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

Paso 2: Agrega compatibilidad con una capa base de mapas y un controlador de vista

Para compartir el progreso del viaje en tu app, agrega las siguientes clases: ConsumerGoogleMap y ConsumerController.

  • Obtén ConsumerGoogleMap de ConsumerMapFragment o ConsumerMapView, que muestran ConsumerGoogleMap de forma asíncrona en ConsumerMapReadyCallback.

    ConsumerGoogleMap es una clase de wrapper para la clase GoogleMap. Usa una API equivalente a GoogleMap para que tu app pueda interactuar con el mapa. De esta manera, tu app puede interactuar sin problemas con el mismo mapa subyacente de Google. Por ejemplo, GoogleMap solo permite un registro de devolución de llamada, pero ConsumerGoogleMap admite devoluciones de llamada registradas dobles. Estas devoluciones de llamada permiten que tu app registre devoluciones de llamada a las que se llama de forma secuencial.

  • Obtén ConsumerController de ConsumerGoogleMap en getConsumerController().

    ConsumerController proporciona acceso a las funciones de uso compartido de viajes, como supervisar viajes, controlar el estado de los viajes y establecer ubicaciones.

Para saber cómo agregar ConsumerGoogleMap y ConsumerController a tu app en Java y Kotlin, consulta los siguientes ejemplos.

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

Paso 3: Agrega compatibilidad con gráficos vectoriales de Android

Si el diseño de tu app requiere compatibilidad con gráficos vectoriales, sigue estos pasos para agregar compatibilidad con dispositivos Android y elementos vectoriales de diseño:

  1. Agrega el siguiente código a tu actividad. Este código extiende AppCompatActivity para usar los elementos vectoriales de diseño en el SDK para consumidores.

Java

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

// ...

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

Kotlin

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

// ...

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

Pasos siguientes

Cómo seguir un viaje en Android

Aplica diseño a un mapa