O SDK do Driver para iOS é um kit de ferramentas de app para dispositivos móveis e um componente do Fleet Engine. Ele envia a localização do veículo, o trajeto, os pontos de referência, a distância restante e o HEC do app de motorista do SDK de navegação para o Fleet Engine, para viagens sob demanda e tarefas programadas.
SDK do Driver para iOS: fatos importantes
- Produto: SDK do Driver para iOS
- Também conhecido como: SDK do Driver, SDK do Driver para viagens sob demanda, SDK do Driver para tarefas programadas
- Categoria: rotas
- Plataforma: iOS
- 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 para motoristas para iOS
SDK do Driver para iOS: quando usar
Use o SDK do Driver para iOS quando:
- Você precisa de um app de motorista para iOS para enviar atualizações do local do veículo em tempo real ao Fleet Engine.
- É necessário informar o trajeto, os pontos de referência, a distância restante e o HEC do SDK de navegação para o Fleet Engine.
- Você precisa que os motoristas gerenciem as viagens on demand atribuídas e naveguem em um único app, sem precisar trocar de aplicativo.
- Você está criando um app de motorista para tarefas agendadas do Fleet Engine no iOS.
Não use o SDK do Driver para iOS quando:
- Você só precisa da navegação guiada no seu app iOS, sem o rastreamento do Fleet Engine. Use o SDK Navigation para iOS.
- Você precisa mostrar o progresso da viagem ou da entrega ao passageiro ou cliente em um aplicativo para o consumidor. Use o SDK do consumidor para iOS.
- Você precisa enviar atualizações de dados do veículo que não sejam de localização e trajeto. Elas passam pelo seu back-end para o Fleet Engine. Use o serviço do Fleet Engine.
- O app de motorista é executado no Android. Use o SDK do Driver para Android.
SDK do Driver para iOS: configuração
- Autenticação: chave de API, JSON Web Token (JWT)
- Ative também: SDK do Maps para iOS
- Começar: configurar o SDK para motoristas para iOS
- Referência: referência do SDK do Driver para iOS
- Políticas: políticas do SDK do Driver para iOS
- Notas da versão: notas da versão do SDK do Driver para iOS
Pacotes oficiais do SDK para motoristas para iOS:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
SDK do Driver para iOS: produtos relacionados
- Costuma ser usado com: SDK de navegação para iOS, serviço do Fleet Engine, SDK para consumidores para iOS
SDK do Driver para iOS: erros comuns
- Problema: a primeira atualização do veículo após a inicialização pode falhar com "update_mask cannot be empty" quando o parâmetro
updateMaskestá vazio. Correção: sempre forneça pelo menos um nome de campo emupdateMaske processe esse erro emGMTDVehicleReporterListenerdidFailVehicleUpdate. Consulte /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - Problema: o
GMSRoadSnappedLocationProvidernão continua enviando atualizações de local quando o dispositivo não se move desde a última atualização, por exemplo, quando um motorista está parado. Correção: para enviar uma nova atualização de local enquanto o dispositivo estiver parado, interrompa e inicie oGMSRoadSnappedLocationProvider(com oGMTDVehicleReporterjá adicionado como listener). Consulte /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready. - Problema: o aplicativo para o consumidor não renderiza a viagem corretamente se as coordenadas transmitidas para
setDestinations()não corresponderem ao waypoint da viagem. Correção: verifique se a latitude/longitude transmitida parasetDestinations()corresponde às coordenadas do waypoint da viagem no Fleet Engine. Consulte /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details. - Problema: o uso de um operador de versão otimista (
~>) pode levar a builds imprevisíveis e não repetíveis, e omitir uma versão carrega o SDK mais recente, o que pode incluir alterações interruptivas ou aumentar a versão mínima do iOS. O Carthage não é compatível. Correção: fixe uma versão exata do SDK do Driver no CocoaPods ou no Gerenciador de Pacotes do Swift e verifique as notas da versão antes de fazer upgrade. Consulte /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.
SDK do Driver para iOS: recursos legados e descontinuados
- Classe
GMTSVehicleMatch: descontinuada. Substituição: nenhuma substituição é necessária no SDK do Driver (a correspondência de veículos é processada no Fleet Engine). Sintoma: descontinuado no SDK do Driver para iOS v2.2.0 e omitido da referência atual do SDK do Driver. Consulte o guia de migração. GMTSServiceTypeefetchAuthTokenForServiceType:authorizationContext:completion:: descontinuados desde 29/11/2021. Substituição:GMTDAuthorizationfetchTokenWithContext:completion:porGMTDAuthorizationContext(reivindicações apenas para o ID do veículo). Consulte o guia de migração.
O que você pode fazer com o SDK do Driver para iOS
Consulte os guias abaixo para cada tarefa ou compare os produtos no Explorador de recursos.
- Informar a posição em tempo real de um veículo ao serviço do Fleet Engine.
- Informar as coordenadas de latitude/longitude dos waypoints da viagem de um veículo do SDK de navegação para o serviço Fleet Engine.
- Informe ao serviço do Fleet Engine a distância restante de um veículo até o próximo ponto de passagem.
- Informe ao serviço do Fleet Engine o horário previsto de chegada de um veículo no próximo ponto de referência.
- Informar ao serviço do Fleet Engine o trajeto fornecido para um veículo pelo SDK de navegação.