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

Com o SDK do consumidor para iOS, os apps de consumidor para iOS podem acompanhar viagens on demand no Fleet Engine. As classes, como GMTCTripModel e GMTCJourneySharingSession, modelam os dados da viagem e mostram a localização do veículo, o trajeto, o HEC e a distância restante em um mapa.

SDK do Consumidor para iOS: informações importantes

  • Produto: SDK para Consumidores para iOS
  • Também conhecido como: SDK do Consumidor para iOS
  • 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 do Consumidor para iOS

SDK do Consumidor para iOS: quando usar

Use o SDK do Consumidor para iOS quando:

  • Você precisa de um app iOS em que os consumidores acompanhem uma viagem de transporte por aplicativo ou entrega sob demanda que o Fleet Engine rastreia.
  • Você precisa mostrar a localização quase em tempo real, o trajeto e o trânsito em tempo real de um veículo em um mapa em um app para o consumidor do iOS.
  • Você precisa mostrar o horário de chegada estimado da retirada e da entrega, além da distância restante para uma viagem sob demanda no iOS.
  • Você já usa o Fleet Engine e o SDK do Driver para viagens sob demanda e precisa do lado do consumidor do compartilhamento de trajeto.

Não use o SDK para Consumidores para iOS quando:

  • Você precisa que os consumidores sigam tarefas ou remessas programadas. A experiência do consumidor de tarefas programadas está documentada para JavaScript. Use o SDK do Consumidor para JavaScript.
  • Você precisa compartilhar o progresso da viagem sob demanda em um app para o consumidor Android. Use o SDK do Consumidor para Android.
  • Você precisa compartilhar o progresso da viagem sob demanda em um app da Web. Use o SDK do JavaScript para Consumidor.
  • Você precisa enviar a localização do motorista e o estado da viagem do app iOS do motorista para o Fleet Engine. Use o SDK do Driver para iOS.

SDK do Consumidor para iOS: configuração

Pacotes oficiais do SDK do Consumidor para iOS:

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

SDK do Consumidor para iOS: erros comuns

  • Problema: o monitoramento de viagens falha com o erro 401 UNAUTHENTICATED quando o JWT é assinado sem um ID de viagem ou expirou. Correção: faça com que o provedor de tokens (GMTCAuthorization) retorne um JWT emitido para o ID da viagem no contexto de autorização, armazene-o em cache por viagem e o atualize quando ele expirar. Consulte /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • Problema: o monitoramento de viagens falha com o erro 400 INVALID_ARGUMENT quando o nome da viagem não usa o formato providers/{provider_id}/trips/{trip_id}. Correção: use o ID do projeto do Google Cloud como provider_id e transmita o mesmo ID do projeto como providerID ao inicializar o SDK. Consulte /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • Problema: o app continua detectando atualizações após a conclusão ou o cancelamento de uma viagem. Correção: chame unregisterSubscriber no modelo de viagem quando ela for concluída ou cancelada. Consulte /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • Problema: as instalações manuais do XCFramework omitem os pacotes de recursos e as configurações de build necessários, a menos que você os adicione no Xcode. Correção: use o CocoaPods sempre que possível. Para instalações manuais, adicione gRPCCertificates.bundle e GoogleRidesharingConsumer.bundle ao projeto, vincule os frameworks listados e adicione -ObjC a "Other Linker Flags" para depuração e lançamento. Consulte /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

SDK do Consumidor para iOS: recursos legados e descontinuados

  • Inicializador GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: descontinuado desde 01/06/2025. Substituição: GMTSVehicleLocation -initWithOptions: por GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: descontinuado desde 01/12/2023. Substituição: GMTCMapView -initWithOptions:.

O que você pode fazer com o SDK para Consumidores para iOS

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