Links diretos

Quando um usuário clica em um resultado da pesquisa de rotas de micromobilidade, o Google Maps para dispositivos móveis (GMM) usa um link direto ou uma "intent" no Android do veículo selecionado fornecido pelo feed de especificação geral do feed de compartilhamento de bicicletas (GBFS).

Para oferecer uma experiência do usuário integrada, este guia descreve a experiência do usuário esperada com links diretos e fornece orientações aos parceiros sobre como formatar links diretos e preparar links diretos de substituição.

A experiência do usuário de rotas de compartilhamento de bicicletas, que começa quando o usuário pesquisa rotas e termina quando ele desbloqueia uma bicicleta no app do parceiro, é resumida da seguinte forma:

  1. No GMM, o usuário seleciona um trajeto de micromobilidade:
    1. O usuário escolhe uma origem e um destino.
    2. O usuário seleciona micromobilidade como meio de transporte.
    3. O usuário escolhe um veículo ou uma estação, se usar um veículo com dock, que ele quer usar.

  2. No app do parceiro, o usuário desbloqueia o veículo:

    1. O usuário clica no botão do GMM para abrir o app do parceiro. O link direto associado ao veículo ou à estação no feed é chamado. Se o link direto associado não for fornecido, o link substituto em Preparar link direto substituto será chamado.

      1. Quando o app do parceiro está instalado:o link direto navega um usuário diretamente para a página de reserva do app do parceiro sem um redirecionamento ou página de destino intermediária.

      2. Quando o app parceiro não está instalado:o link direto navega um usuário diretamente para a página de instalação do app parceiro sem um redirecionamento ou página de destino intermediária.

    2. O app do parceiro abre e carrega a "tela de estação/bicicleta", que permite ao usuário desbloquear o veículo.

      1. Os usuários veem informações extras que o parceiro quer mostrar, como lugares para estacionar, dicas de segurança e como desbloquear o veículo.
      2. O usuário pode destrancar o veículo.

  3. Navegar

    1. Para começar a jornada, o usuário volta ao GMM e inicia o modo de navegação.

Para ter uma experiência fluida entre o GMM, o app do parceiro e a página de instalação do app do parceiro, sem redirecionamentos adicionais, o parceiro precisa implementar links universais do iOS e links do app Android ao especificar os links diretos fornecidos no feed.

Ao criar os links diretos, o parceiro pode incorporar qualquer quantidade de informações necessárias para identificar um veículo ou uma estação e direcionar os usuários diretamente para a página de reserva sem um redirecionamento ou uma página de destino intermediária.

O parceiro pode optar por não usar bike_id ou station_id. Além disso, outras informações adicionais, como tags de rastreamento, podem ser incluídas.

Confira um exemplo de link direto:

https://www.example.com/app?event_tag=93581&vid=4917538

O Google sempre vai anexar um parâmetro client_id adicional com o valor GOOGLE_MAPS ao link direto para ajudar os parceiros a identificar que o Google Maps acionou o link direto. Qualquer client_id existente é removido.

Confira abaixo um exemplo de link direto com client_id adicionado:

https://www.example.com/app?event_tag=93581&vid=4917538&client_id=GOOGLE_MAPS

O parceiro também precisa gerar um link direto universalmente aplicável, independente de veículos individuais ou estações de encaixe, para iOS e Android. Esses links são usados como um mecanismo de substituição caso os links diretos para o veículo ou a estação de acoplamento selecionados não sejam fornecidos no feed.

Depois que o parceiro gerar os links diretos substitutos, ele precisará fornecê-los ao Google como parte da fase de pré-implementação.