Referência rápida do SDK do consumidor para JavaScript

Com o SDK do Consumidor para JavaScript, um aplicativo para o consumidor baseado na Web pode mostrar em um mapa a localização de veículos e outros locais de interesse rastreados no Fleet Engine. Assim, os consumidores podem acompanhar o progresso de uma viagem on demand ou de uma entrega programada. Ela é carregada como a biblioteca journeySharing da API Maps JavaScript.

SDK do JavaScript para Consumidor: fatos importantes

  • Produto: SDK do consumidor para JavaScript
  • Também conhecido como: SDK do consumidor para JavaScript, JavaScript de viagens on demand dos serviços de mobilidade, SDK para JavaScript
  • Categoria: rotas
  • Plataforma: JavaScript (navegador)
  • Executado em: cliente (código do app ou do navegador)
  • Estágio de lançamento: GA
  • Ciclo de vida: Ativo
  • Visão geral: Visão geral do SDK do Consumidor para JavaScript

SDK do consumidor para JavaScript: quando usar

Use o SDK do Consumidor para JavaScript quando:

  • Você precisa mostrar aos consumidores a localização em tempo real e o trajeto de um veículo em uma viagem sob demanda que o Fleet Engine rastreia, em uma página ou um app da Web.
  • Você precisa permitir que os consumidores acompanhem o progresso da retirada ou entrega de uma remessa programada rastreada no Fleet Engine em um navegador.
  • Você precisa mostrar o HEC, a distância restante e o trânsito em tempo real no trajeto de uma viagem em uma visualização de mapa de base baseada na Web.
  • Você precisa personalizar os marcadores de viagem, as polilinhas de trajeto ou o estilo de mapa em uma visualização de rastreamento do consumidor na Web.

Não use o SDK do Consumidor para JavaScript quando:

  • Você precisa de uma experiência de acompanhamento de viagem para o consumidor em um app Android nativo. Use o SDK do consumidor para Android.
  • Você precisa de uma experiência do consumidor de acompanhamento de viagem em um app iOS nativo. Use o SDK para consumidores para iOS.
  • É necessário informar o local do motorista e o progresso da viagem do app Android do motorista para o Fleet Engine. Use o SDK do Driver para Android.
  • É necessário informar a localização do motorista e o progresso da viagem do app iOS do motorista para o Fleet Engine. Use o SDK do Driver para iOS.
  • Você precisa de um mapa da Web geral que não siga as viagens ou tarefas do Fleet Engine. Use a API Maps JavaScript.

SDK do Consumidor para JavaScript: configuração

SDK do consumidor para JavaScript: erros comuns

  • Problema: se você não definir uma janela de visualização inicial (centro e zoom) para o mapa JourneySharingMapView, o evento 'ready' dele pode não ser acionado. Correção: chame mapView.map.setCenter(...) e mapView.map.setZoom(...) depois de criar a visualização do mapa. Consulte /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problema: os erros de solicitações assíncronas de informações de viagem não são gerados. Eles chegam apenas como eventos 'error' no provedor de localização, então passam despercebidos, a menos que você adicione um listener. Correção: adicione locationProvider.addListener('error', ...) e envolva as chamadas de biblioteca em blocos try...catch. Consulte /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problema: as classes google.maps.journeySharing só ficam disponíveis se você carregar a biblioteca journeySharing. Correção: adicione libraries=journeySharing ao URL do script da API Maps JavaScript ou carregue as classes com await google.maps.importLibrary("journeySharing"). Consulte /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problema: as chamadas do Fleet Engine no navegador (um ambiente de baixa confiança) precisam de JWTs emitidos pelo servidor de back-end. Uma chave de API por si só não autoriza o acesso aos dados da viagem. Correção: emita JWTs do seu back-end e forneça um authTokenFetcher que retorne o token e o expiresInSeconds. Consulte /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.

SDK do Consumidor para JavaScript: recursos legados e descontinuados

  • Opções de configuração de marcador e polilinha JourneySharingMapView e JourneySharingMapViewOptions (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup e outras): descontinuadas. Substituição: opções MarkerCustomizationFunction e PolylineCustomizationFunction no provedor de localização (por exemplo, vehicleMarkerCustomization). Sintoma: remoção programada para uma versão futura. Consulte o guia de migração.
  • JourneySharingMapView.locationProvider e JourneySharingMapViewOptions.locationProvider: descontinuados. Substituição: JourneySharingMapView.locationProviders e JourneySharingMapViewOptions.locationProviders.
  • JourneySharingMapView Propriedades de lista de marcadores e polilinhas (vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines e propriedades de marcador de tarefa): descontinuadas. Substituição: callbacks MarkerCustomizationFunction e PolylineCustomizationFunction no provedor de localização. Consulte o guia de migração.

O que você pode fazer com o SDK do Consumidor para JavaScript

Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.