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
- Autenticação: chave de API, JSON Web Token (JWT)
- Ative também: API Maps JavaScript, serviço do Fleet Engine
- Atribuição de uso: ID da transação de mobilidade opcional (Beta). Defina
google.maps.Settings.getInstance().experienceIdscomo uma matriz de IDs de transação de mobilidade (ou IDs relacionados) antes de criar umJourneySharingMapView.experienceIdsestá disponível apenas no canalv=betada API Maps JavaScript. - Começar: configurar o SDK do Consumidor para JavaScript
- Referência: Referência do SDK do Consumidor para JavaScript
- Notas da versão: notas da versão do SDK do Consumidor para JavaScript
SDK do consumidor para JavaScript: produtos relacionados
- Costuma ser usado com: serviço do Fleet Engine, API Maps JavaScript, SDK do Driver para Android, SDK do Driver para iOS
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: chamemapView.map.setCenter(...)emapView.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: adicionelocationProvider.addListener('error', ...)e envolva as chamadas de biblioteca em blocostry...catch. Consulte /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problema: as classes
google.maps.journeySharingsó ficam disponíveis se você carregar a bibliotecajourneySharing. Correção: adicionelibraries=journeySharingao URL do script da API Maps JavaScript ou carregue as classes comawait 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
authTokenFetcherque retorne o token e oexpiresInSeconds. 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
JourneySharingMapVieweJourneySharingMapViewOptions(vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupe outras): descontinuadas. Substituição: opçõesMarkerCustomizationFunctionePolylineCustomizationFunctionno provedor de localização (por exemplo,vehicleMarkerCustomization). Sintoma: remoção programada para uma versão futura. Consulte o guia de migração. JourneySharingMapView.locationProvidereJourneySharingMapViewOptions.locationProvider: descontinuados. Substituição:JourneySharingMapView.locationProviderseJourneySharingMapViewOptions.locationProviders.JourneySharingMapViewPropriedades de lista de marcadores e polilinhas (vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinese propriedades de marcador de tarefa): descontinuadas. Substituição: callbacksMarkerCustomizationFunctionePolylineCustomizationFunctionno 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.
- Adicione uma polilinha de trajeto que rastreia uma viagem do Fleet Engine a um mapa em uma página da Web ou um app para dispositivos móveis.
- Atualize o progresso da viagem ao longo de um trajeto em um mapa em uma página da Web ou em um app para dispositivos móveis para uma viagem do Fleet Engine.
- Mude o estilo de vias, polilinhas e polígonos em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Mostrar ou ocultar elementos em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Mude o estilo dos ícones e dos rótulos de texto em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Aplique estilos de mapa diferentes a níveis de zoom distintos em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Mudar a densidade de lugares em um mapa que acompanha o progresso de uma viagem do Fleet Engine. Experimental Observação: o suporte à Estilização de Mapas Baseada na Nuvem no SDK para Consumidores está em disponibilidade geral, enquanto o controle de densidade de PDIs é um recurso experimental da Estilização de Mapas Baseada na Nuvem (compatível apenas com estilos de mapa claros).
- Mudar o estilo dos edifícios em um mapa que acompanha o progresso de uma viagem do Fleet Engine. Experimental Observação: o suporte à Estilização de Mapas Baseada na Nuvem no SDK do Consumidor está em disponibilidade geral, enquanto a personalização do estilo de construção em 3D e de pegada é um recurso experimental da Estilização de Mapas Baseada na Nuvem (compatível apenas com estilos de mapa claros).
- Mudar o estilo dos pontos de referência em um mapa que acompanha o progresso de uma viagem do Fleet Engine. Experimental Observação: o suporte à Estilização de Mapas Baseada na Nuvem no SDK para Consumidores está em disponibilidade geral, enquanto a personalização de ícones de pontos de referência é um recurso experimental da Estilização de Mapas Baseada na Nuvem (compatível apenas com estilos de mapa claros).
- Personalize um marcador em um mapa que acompanha o progresso de uma viagem do Fleet Engine.
- Personalize a polilinha do trajeto em um mapa que acompanha o progresso de uma viagem do Fleet Engine.