Referência rápida do SDK do Driver para iOS

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

Pacotes oficiais do SDK para motoristas para iOS:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

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 updateMask está vazio. Correção: sempre forneça pelo menos um nome de campo em updateMask e processe esse erro em GMTDVehicleReporterListener didFailVehicleUpdate. Consulte /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Problema: o GMSRoadSnappedLocationProvider nã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 o GMSRoadSnappedLocationProvider (com o GMTDVehicleReporter já 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 para setDestinations() 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.
  • GMTSServiceType e fetchAuthTokenForServiceType:authorizationContext:completion:: descontinuados desde 29/11/2021. Substituição: GMTDAuthorization fetchTokenWithContext:completion: por GMTDAuthorizationContext (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.