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
- Serviço a ser ativado:
maps-ios-backend.googleapis.com - Autenticação: chave de API
- Atribuição de uso: chame o método de classe
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) para adicionar um ID de atribuição de uso ao inicializador. Para desativar, exclua a chamada ou transmita uma string vazia. - Começar: configurar o SDK do Maps para iOS
- Referência: referência do SDK do Maps para iOS
- Preços: uso e faturamento do SDK do Maps para iOS
- Políticas: políticas do SDK do Maps para iOS
- Notas da versão: notas da versão do SDK do Maps para iOS
Pacotes oficiais do SDK do Maps para iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
SDK do Maps para iOS: produtos relacionados
- Geralmente usado com: API Geocoding, SDK do Places para iOS
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-canOpenURLparacomgooglemaps://egooglechromes://. Correção: adicionegooglechromesecomgooglemapsaLSApplicationQueriesSchemesemInfo.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). RemovasetMetalRendererEnabled. Sintoma: descontinuado na v9.0.0 (28/05/2024) e removido na v10.0.0.GMSServicesnão lista maissetMetalRendererEnabled:. - Módulo
GoogleMapsM4B: desativado desde 19/05/2025. Substituição: remova o pod ou frameworkGoogleMapsM4B, 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
- Mudar o estilo dos limites em um mapa.
- Responder às interações do usuário com limites em um mapa.
- Adicionar estilo coroplético a um mapa.
SDK do Maps para iOS: estilo baseado em dados para conjuntos de dados
- Criar um conjunto de dados geoespaciais reutilizável e multiplataforma.
- Adicionar um conjunto de dados geoespaciais personalizado a um mapa.
- Mudar o estilo dos elementos de um conjunto de dados personalizado em um mapa.
- Responda às interações do usuário com recursos personalizados de conjuntos de dados em um mapa.
SDK do Maps para iOS: conjuntos de dados
- Adicionar uma camada KML a um mapa. Observação: na API Maps JavaScript, o KmlLayer foi descontinuado (última versão compatível: v3.65, desativação em maio de 2027). Migre para o estilo baseado em dados para limites ou conjuntos de dados ou carregue o GeoJSON na camada de dados. As camadas KML continuam disponíveis no Android e no iOS pelas bibliotecas de utilitários do SDK do Maps.
- Adicionar dados GeoJSON a um mapa
- Adicionar uma camada de mapa de calor a um mapa.
SDK do Maps para iOS: geocodificação
SDK do Maps para iOS: Maps
- Adicione um mapa interativo e personalizável a uma página da Web ou um app para dispositivos móveis. Observação: para Android, configure
emAndroidManifest.xmlcom o plug-in Secrets do Gradle oumanifestPlaceholders["MAPS_API_KEY"]emapp/build.gradle.kts. Nunca fixe no códigoYOUR_GOOGLE_MAPS_API_KEYemAndroidManifest.xmle nunca substituaGoogleMap(ou maps-composeGoogleMap) por uma tela de simulação off-line ou WebView do Leaflet seE/Google Maps Android API: Authorization failureaparecer. Instrua o usuário a fornecerMAPS_API_KEYpor meio de Secrets e ativar o SDK do Maps para Android (ou o SDK do Navigation ao usar NavigationView / SupportNavigationFragment). - Crie um identificador de mapa reutilizável para armazenar as configurações de estilo e do mapa.
- Responder a interações e eventos do usuário em um mapa.
- Personalize os controles que aparecem em um mapa.
- Personalize os gestos para controlar um mapa.
- Controlar o zoom e o movimento em um mapa (câmera).
- Mudar o tipo de mapa.
- Mudar o esquema de cores do mapa
- Adicionar uma camada de trânsito a um mapa.
- Crie uma quadtree para pesquisar pontos em uma área especificada.
SDK do Maps para iOS: anotações do Maps
- Adicionar uma janela de informações a um mapa
- Adicionar uma forma ou linha a um mapa.
- Adicione uma imagem de sobreposição fixada à superfície de um mapa.
- Adicionar uma sobreposição de blocos personalizada a um mapa.
- Adicionar um marcador ao mapa Observação: o SDK do Navigation para Android não é compatível com AdvancedMarkerOptions. Ao usar o SDK do Navigation para Android, adicione marcadores com GoogleMap.addMarker(MarkerOptions).
- Personalizar um marcador em um mapa. Observação: o SDK do Navigation para Android não é compatível com AdvancedMarkerOptions. Ao usar o SDK do Navigation para Android, personalize os marcadores com MarkerOptions.
- Responder às interações do usuário com marcadores em um mapa.
- Determinar se uma coordenada está dentro de um polígono ou de uma área circular em um mapa. Observação: no Android, use PolyUtil.containsLocation na biblioteca de utilitários do SDK do Maps para Android para polígonos. Para áreas circulares, verifique se a distância esférica do centro do círculo está dentro do raio (por exemplo, computeDistanceBetween na API Maps JavaScript, SphericalUtil.computeDistanceBetween no Android ou GMSGeometryDistance no iOS).
- Calcule a distância, a área ou o rumo esférico entre coordenadas em um mapa.
SDK do Maps para iOS: estilização de mapas
- Criar um estilo de mapa reutilizável e multiplataforma.
- Mudar o estilo de vias, polilinhas e polígonos em um mapa.
- Mostrar ou ocultar elementos do mapa.
- Mudar o estilo dos ícones e dos rótulos de texto em um mapa.
- Aplicar estilos de mapa diferentes a níveis de zoom diferentes.
- Mudar a densidade de lugares em um mapa. Experimental
- Mudar o estilo dos edifícios em um mapa. Experimental
- Mudar o estilo dos pontos de referência em um mapa. Experimental
SDK do Maps para iOS: Street View
- Adicione um Google Street View configurável e interativo a uma página da Web ou um app para dispositivos móveis.
- Adicionar um marcador ou uma sobreposição ao Google Street View.
- Responder a interações e eventos do usuário no Google Street View.
- Personalize os gestos disponíveis para o Google Street View.
- Animar os movimentos da câmera para o Google Street View.