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

Com o SDK do Maps para iOS, você pode adicionar mapas com base nos dados do Google Maps em apps iOS. O SDK controla o acesso aos servidores do Google Maps, a exibição de mapas e a resposta às interações do usuário, além de permitir que você adicione marcadores, polilinhas, sobreposições de solo e janelas de informações ao mapa.

SDK do Maps para iOS: informações importantes

  • Produto: SDK do Maps para iOS
  • Também conhecido como: SDK do Maps para iOS
  • Categoria: Maps
  • 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 Maps para iOS
  • Disponibilidade regional: global. Consulte a página de cobertura da Plataforma Google Maps. Os links da página de uso e faturamento separam as listas de preços globais e da Índia. (detalhes da cobertura)

SDK do Maps para iOS: quando usar

Use o SDK do Maps para iOS quando:

  • Você precisa de um mapa interativo do Google com processamento de gestos em um app iOS nativo.
  • Você precisa adicionar marcadores, polilinhas, sobreposições de solo ou janelas de informações a um mapa em um app iOS.
  • Você precisa mostrar panoramas do Street View em um app iOS.
  • Você precisa fazer a geocodificação inversa de coordenadas em endereços de um app iOS que mostra um mapa.

Não use o SDK do Maps para iOS quando:

  • Você precisa de mapas 3D fotorrealistas em um app iOS. Use o SDK do Maps 3D para iOS.
  • Você só precisa abrir um local ou rotas no app Google Maps em vez de renderizar um mapa no seu app. Use os URLs do Maps.

SDK do Maps para iOS: configuração

Pacotes oficiais do SDK do Maps para iOS:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

SDK do Maps para iOS: erros comuns

  • Problema: o SDK não é compatível com bibliotecas mescláveis. Ativar a opção "Build Mergeable Library" no Xcode causa falhas no vinculador em builds de lançamento. Correção: mantenha a configuração "Build Mergeable Library" definida como "No" (o padrão). Consulte /maps/documentation/ios-sdk/config.
  • Problema: sem as entradas LSApplicationQueriesSchemes, tocar no logotipo do Google no mapa registra falhas de -canOpenURL para comgooglemaps:// e googlechromes://. Correção: adicione googlechromes e comgooglemaps a LSApplicationQueriesSchemes em Info.plist. Consulte /maps/documentation/ios-sdk/config.
  • Problema: é improvável que o uso do SDK em extensões de apps iOS (por exemplo, um teclado personalizado) funcione devido a restrições de memória rígidas. Correção: use o SDK no app principal, não nas extensões. Consulte /maps/documentation/ios-sdk/overview.
  • Problema: o SDK não é otimizado para várias janelas ou instâncias simultâneas do iPadOS 13 ou versões mais recentes e pode apresentar um comportamento indefinido. Correção: teste com cuidado os cenários de várias janelas no iPad ou evite várias instâncias simultâneas de mapas. Consulte /maps/documentation/ios-sdk/overview.

SDK do Maps para iOS: recursos legados e descontinuados

  • Renderizador OpenGL e setMetalRendererEnabled: desativados desde 19/05/2025. Substituição: renderizador Metal (padrão desde a v8.0.0). Remova setMetalRendererEnabled. Sintoma: descontinuado na v9.0.0 (28/05/2024) e removido na v10.0.0. GMSServices não lista mais setMetalRendererEnabled:.
  • Módulo GoogleMapsM4B: desativado desde 19/05/2025. Substituição: remova o pod ou framework GoogleMapsM4B, que está relacionado a um plano de faturamento obsoleto. Sintoma: descontinuado em 20/02/2024; removido do pacote Swift na v9.0.0 e do SDK na v10.0.0.
  • Distribuição do CocoaPods: descontinuada desde 06/08/2026. Substituição: Gerenciador de pacotes do Swift. Sintoma: modo de manutenção desde 18/08/2025; descontinuado a partir da versão 11.0.0. Consulte o guia de migração.
  • Instalação do Carthage: descontinuada desde 27/06/2022. Substituição: Gerenciador de pacotes do Swift. Sintoma: o Carthage não é compatível com bibliotecas para iOS 13 ou versões mais recentes. A versão mais recente disponível no Carthage é a 6.2.1. Consulte o guia de migração.

O que você pode fazer com o SDK do Maps para iOS

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

SDK do Maps para iOS: estilo baseado em dados para limites

SDK do Maps para iOS: estilo baseado em dados para conjuntos de dados

SDK do Maps para iOS: conjuntos de dados

SDK do Maps para iOS: geocodificação

SDK do Maps para iOS: Maps

SDK do Maps para iOS: anotações do Maps

SDK do Maps para iOS: estilização de mapas

SDK do Maps para iOS: Street View