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
- Autenticação: JSON Web Token (JWT)
- Ative também: Serviço do Fleet Engine
- Começar: configurar o SDK do Consumidor para iOS
- Referência: referência do SDK do Consumidor para iOS
- Políticas: Políticas do SDK do Consumidor para iOS
- Notas da versão: notas da versão do SDK do Consumidor para iOS
Pacotes oficiais do SDK do Consumidor para iOS:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
SDK do Consumidor para iOS: produtos relacionados
- Costuma ser usado com: serviço do Fleet Engine, SDK do Driver para iOS, SDK do Driver para Android, SDK do Maps para iOS
SDK do Consumidor para iOS: erros comuns
- Problema: o monitoramento de viagens falha com o erro 401
UNAUTHENTICATEDquando 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_ARGUMENTquando o nome da viagem não usa o formatoproviders/{provider_id}/trips/{trip_id}. Correção: use o ID do projeto do Google Cloud comoprovider_ide transmita o mesmo ID do projeto comoproviderIDao 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
unregisterSubscriberno 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.bundleeGoogleRidesharingConsumer.bundleao projeto, vincule os frameworks listados e adicione-ObjCa "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:porGMTSVehicleLocationOptions. [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.
- Adicione um mapa interativo e personalizável que acompanha o progresso de uma viagem do Fleet Engine para um app para dispositivos móveis.
- 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.