Personalizar marcadores

Selecione a plataforma: Android iOS JavaScript

A classe ConsumerMapStyle oferece os métodos setter e getter com personalização dinâmica para marcadores e polilinhas. Exponha essa classe de forma assíncrona usando o método ConsumerController.getConsumerMapStyle().

A personalização da interface persiste nas rotações do dispositivo e permanece em vigor até que você remova o ConsumerController.

Personalizar marcadores

Para definir o tipo de marcador e as propriedades dele, use o método ConsumerMapStyle.setMarkerStyleOptions(). Suas opções de marcador personalizado substituem os valores padrão fornecidos pelo SDK do consumidor. Para restaurar os valores padrão, chame setMarkerStyleOptions() usando null para o parâmetro MarkerOptions. Recupere o MarkerOptions ativo usando getMarkerStyleOptions().

Selecionar um tipo de marcador

Você pode usar e personalizar os seguintes ícones de marcadores:

• TRIP_PICKUP_POINT: aparece ao seguir uma viagem
• TRIP_DROPOFF_POINT: aparece ao seguir uma viagem
• TRIP_INTERMEDIATE_DESTINATION

• TRIP_VEHICLE: aparece ao seguir uma viagem

  O SDK para consumidores atualiza a rotação do ícone TRIP_VEHICLE durante o monitoramento de viagens para imitar o comportamento do veículo real enquanto ele percorre o trajeto.

Observação: para resultados de animação mais realistas, use uma perspectiva de vista superior para TRIP_VEHICLE, com a parte frontal do veículo orientada para cima.

Observação: o ícone do marcador não muda de acordo com o tipo de veículo real da viagem.

Selecionar opções do marcador

Para personalizar marcadores no app do consumidor, siga estas etapas:

1. Use as propriedades de cada marcador fornecido pelo Google Maps MarkerOptions.

2. Crie MarkerOptions usando o construtor.

3. Especifique propriedades personalizadas usando métodos do estilo "Setter".

   Observação: como o SDK fornece valores padrão para cada propriedade do marcador, especifique apenas propriedades personalizadas para os valores que você quer mudar.

4. Se preferir, use seu próprio elemento de interface imitando os padrões fornecidos pelo construtor MarkerOptions.

5. Para desativar um marcador, defina a propriedade visible como false. É possível usar seu próprio elemento de interface no lugar dele.

Para mais informações, consulte o Google Maps MarkerOptions.

Exemplos de personalizações de marcadores

Java

// Initializing marker options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setMarkerStyleOptions(
              MarkerType.TRIP_VEHICLE,
              new MarkerOptions()
                  .visible(false));
        });

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null);

Kotlin

// Initializing marker options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, MarkerOptions().visible(false))
  })

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null)

A seguir

• Personalizar polilinhas do trajeto