Depois de ativar o faturamento e criar uma chave de API, você poderá configurar o projeto do Xcode usado para desenvolver seu app.
As notas da versão estão disponíveis para cada versão.
Etapa 1: instalar o software necessário
Para criar um projeto usando o SDK do Places para iOS, você precisa de:
- Xcode versão 26.0 ou mais recente
Etapa 2: criar o projeto do Xcode e instalar o SDK do Places para iOS
Gerenciador de pacotes do Swift
O SDK do Places para iOS pode ser instalado pelo Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK do Places para iOS.
Para adicionar o SDK a um projeto novo ou atual, siga estas etapas:
-
Abra o
projectouworkspacedo Xcode e acesse File > Add Package Dependencies. - Insira https://github.com/googlemaps/ios-places-sdk como o URL, pressione Enter para extrair o pacote e clique em "Add Package".
-
Para instalar um
versionespecífico, defina o campo Regra de dependência como uma das opções baseadas em versão. Para novos projetos, recomendamos especificar a versão mais recente e usar a opção "Exact Version". Quando terminar, clique em "Adicionar pacote". - Na janela Choose Package Products, verifique se
GooglePlaces,GooglePlacesSwiftou ambos serão adicionados ao destino principal designado. Quando terminar, clique em Adicionar pacote.Se você estiver atualizando o Google Places Swift do URL descontinuado do GitHub
Importante: o URL do GitHub para acessar o Google Places Swift mudou a partir da versão 0.3.0. Se você estiver atualizando uma versão do GooglePlacesSwift que foi acessada pelo URL antigo,
https://github.com/googlemaps/ios-places-swift-sdk, remova-a da seção de dependências de pacotes do Xcode. - Para verificar a instalação, acesse o painel General do destino. Em Frameworks, Libraries, and Embedded Content, você verá os pacotes instalados. Você também pode conferir a seção Package Dependencies do Project Navigator para verificar o pacote e a versão dele.
Para atualizar o package de um projeto, siga estas etapas:
-
No Xcode, acesse File > Packages > Update To Latest Package Versions.
Se você estiver atualizando o Google Places Swift do URL descontinuado do GitHub
Importante: o URL do GitHub para acessar o Google Places Swift mudou a partir da versão 0.3.0. Se você estiver atualizando uma versão do GooglePlacesSwift que foi acessada pelo URL antigo,
https://github.com/googlemaps/ios-places-swift-sdk, remova-a da seção de dependências de pacotes do Xcode. - Para verificar a instalação, acesse a seção Package Dependencies do Project Navigator para verificar o pacote e a versão dele.
Para remover o SDK do Places para iOS instalado manualmente, siga estas etapas:
-
Nas configurações do projeto do Xcode, encontre Frameworks, Libraries,
and Embedded Content. Use o sinal de menos (-) para remover os seguintes frameworks:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
No diretório de nível superior do projeto do Xcode, remova o pacote
GooglePlaces.
Instalação manual
Neste guia, mostramos como adicionar manualmente os XCFrameworks que contêm o SDK do Places para iOS e o SDK do Places para Swift para iOS ao seu projeto e definir as configurações de build no Xcode. Um XCFramework é um pacote binário que pode ser usado em várias plataformas, incluindo máquinas que usam o Apple Silicon. Você pode adicionar o SDK do Places para iOS, o SDK do Places para iOS em Swift ou ambos.
- Faça o download dos seguintes arquivos binários e de recursos do SDK:
- Se você estiver instalando o SDK do Places para iOS em Swift, instale os seguintes arquivos:
- Extraia os arquivos para acessar o XCFramework e os recursos.
- Inicialize o Xcode e abra ou crie um projeto. Se você não tem muita experiência com o desenvolvimento para iOS, crie um novo projeto e selecione o modelo de app iOS.
- Remova todas as versões anteriores do Maps do projeto.
-
Abra a guia Geral. Arraste o seguinte XCFramework para seu projeto
em Frameworks, Libraries, and Embedded Content. Selecione
Não incorporar:
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
Copie o
GooglePlaces.bundledo GooglePlacesResources que você baixou para o diretório de nível superior do seu projeto do Xcode. Selecione Copiar itens para a pasta do grupo de destino quando solicitado.
Se você estiver instalando o SDK do Places para Swift, copie oGooglePlacesSwift.bundledo GooglePlacesSwiftResources que você baixou para o diretório de nível superior do seu projeto do Xcode. Selecione Copiar itens para a pasta do grupo de destino quando solicitado. - Selecione seu projeto no Project Navigator e escolha o destino do aplicativo.
-
Abra a guia Build Phases. Em Link Binary with
Libraries, adicione os seguintes frameworks e bibliotecas:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Linking - General -> Other Linker Flags, adicione
-ObjCa "Debug" e "Release". Se essas configurações não estiverem visíveis, mude o filtro na barra Build Settings de Basic para All.
Etapa 3: adicionar a chave de API ao seu app
Nos exemplos a seguir, substitua YOUR_API_KEY pela chave de API.
Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:
- Adicione a seguinte declaração de importação:
import GooglePlacesSwift
- Adicione o seguinte ao método
application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY pela sua chave de API:PlacesClient.provideAPIKey("YOUR_API_KEY")
Swift
Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:
- Adicione a seguinte declaração de importação:
import GooglePlaces
- Adicione o seguinte ao método
application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY pela sua chave de API:GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
Objective-C
Inclua sua chave de API ao AppDelegate.m da seguinte maneira:
- Adicione a seguinte declaração de importação:
@import GooglePlaces;
- Adicione o seguinte ao método
application:didFinishLaunchingWithOptions:, substituindo YOUR_API_KEY pela sua chave de API:[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
Etapa 4 (opcional): inspecionar o arquivo de manifesto de privacidade da Apple
A Apple exige detalhes de privacidade para apps na App Store. Acesse a página de detalhes de privacidade da App Store da Apple para ver atualizações e mais informações.
O arquivo de manifesto de privacidade da Apple está incluído no pacote de recursos do SDK. Para verificar se o arquivo de manifesto de privacidade foi incluído e inspecionar o conteúdo dele, crie um arquivo do app e gere um relatório de privacidade com base nele.
Próximas etapas
- Comece a escrever o código. Um ponto de partida recomendado é implementar um app inicial que mostre o local atual do usuário.
- Depois de configurar o projeto, você pode conferir os apps de exemplo.
- Use o App Check para proteger sua chave de API.