Configuração

Esta página descreve o que você precisa fazer para começar a criar com o SDK 3D do Maps para iOS. O processo de configuração envolve configurar um projeto e uma API do Google Cloud para uso com o SDK e, em seguida, configurar um projeto Xcode. Conclua estas etapas antes de adicionar seu primeiro mapa 3D ao app.

Configurar uma chave de API e um projeto do Google Cloud

Antes de começar a criar com o SDK 3D do Maps para iOS, você precisa configurar um projeto do Google Cloud e uma chave de API para usar com o SDK 3D do Maps para iOS. Para isso, siga estas etapas:

Etapa 1

Console

  1. No console do Google Cloud, na página do seletor de projetos, clique em Criar projeto para começar a criar um novo projeto do Cloud.

    Acessar a página do seletor de projetos

  2. Verifique se o faturamento está ativado para seu projeto do Cloud. Confirme se o faturamento está ativado no projeto.

    É possível testar o Google Cloud sem pagar nada. O teste expira em 90 dias ou quando a conta acumular US$ 300 em cobranças, o que ocorrer primeiro. É possível cancelar a qualquer momento. Para mais informações, consulte Créditos da conta de faturamento e Faturamento.

SDK do Cloud

gcloud projects create "PROJECT"

Saiba mais sobre o SDK Google Cloud, a instalação do SDK Cloud e os seguintes comandos:

Etapa 2

Para utilizar a Plataforma Google Maps, ative as APIs ou os SDKs que você planeja usar com seu projeto.

É preciso ativar vários SDKs/APIs para algumas integrações. Se você não souber quais APIs ou SDKs ativar, use o Seletor de APIs ou consulte a documentação do recurso que gostaria de utilizar.

Para ativar uma ou mais APIs ou SDKs, faça o seguinte:

Console

  1. Confira as APIs e os SDKs da Plataforma Google Maps que você pode ativar acessando a página "Biblioteca de APIs Maps" no console do Cloud:

    Acessar a página Biblioteca de APIs Maps

  2. Clique na API ou no SDK que você quer ativar.
    • Se houver um botão ATIVAR, clique nele.
    • Se houver um botão GERENCIAR, a API ou o SDK já está ativado e você não precisa fazer mais nada.
    • Quando você clica em um desses botões, o painel da API ou do SDK é exibido. Clique em DESATIVAR para remover a API ou o SDK do projeto.

SDK do Cloud

O comando a seguir ativa todas as APIs Maps, Routes e Places:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Saiba mais sobre o SDK Google Cloud, a instalação do SDK Cloud e os seguintes comandos:

Use este comando para ativar as APIs do ambiente:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com"

Etapa 3

Essa etapa só passa pelo processo de criação da chave de API. Se você usa sua chave de API na produção, recomendamos restringi-la. Para mais informações, consulte a página Como usar chaves de API específica do produto.

A chave de API é um identificador exclusivo que autentica solicitações associadas ao seu projeto para fins de uso e faturamento. Você precisa ter pelo menos uma chave de API associada ao projeto.

Para criar uma chave de API, siga estas etapas:

Console

  1. Acesse a página Plataforma Google Maps > Credenciais.

    Acessar a página "Credenciais"

  2. Na página Credenciais, clique em Criar credenciais > Chave de API.
    A caixa de diálogo Chave de API criada exibirá sua chave recém-criada.
  3. Clique em Fechar.
    A nova chave vai aparecer na página Credenciais, em Chaves de API.
    Lembre-se de restringir a chave de API antes de usar na produção.

SDK Cloud

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Saiba mais sobre o SDK Google Cloud, a instalação do SDK Cloud e os seguintes comandos:

Para ativar o SDK, consulte a página SDK do Maps 3D para iOS no console do Google Cloud. Para mais informações sobre como concluir essas etapas, consulte Primeiros passos com a Plataforma Google Maps.

Configurar um projeto do Xcode

Esta seção explica como criar e configurar um projeto do Xcode para uso com o SDK 3D do Maps para iOS.

Depois de ativar o faturamento e criar uma chave de API, você estará pronto para configurar o projeto Xcode usado para desenvolver seu app.

Etapa 1: instalar o software necessário

Para criar um projeto usando o SDK do Maps 3D para iOS, faça o download e instale:

  • Xcode versão 16.0 ou mais recente

Etapa 2: criar o projeto do Xcode e instalar o SDK do Maps 3D para iOS

Gerenciador de pacotes do Swift

O SDK do Maps 3D para iOS pode ser instalado usando o Gerenciador de pacotes do Swift.

Para adicionar o SDK a um projeto novo ou existente, siga estas etapas:

  • Abra o Xcode project ou workspace e acesse File > Add Package Dependencies.
  • Insira https://github.com/googlemaps/ios-maps-3d-sdk como o URL, pressione Enter para extrair o pacote e clique em "Adicionar pacote".
  • Na janela Escolher produtos do pacote, verifique se GoogleMaps3D será adicionado ao destino principal designado. Quando terminar, clique em Adicionar pacote.
  • Para verificar a instalação, navegue até o painel Geral do destino. Em Frameworks, bibliotecas e conteúdo incorporado, você vai encontrar os pacotes instalados. Você também pode conferir a seção Dependências do pacote do Project Navigator para verificar o pacote e a versão dele.

Etapa 3: adicionar a chave de API ao app

Gerenciador de pacotes do Swift

Adicione a chave de API ao ponto de entrada principal do app (ou a qualquer momento antes do carregamento do mapa) da seguinte maneira:

  1. Adicione esta declaração import: 
    import GoogleMaps3D
  2. Adicione o método a seguir. Substitua YOUR_API_KEY pela sua chave de API. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

Etapa 4 (opcional): inspecionar o arquivo de manifesto de privacidade da Apple

A Apple exige detalhes de privacidade para apps na App Store.

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, crie um arquivo do app e gere um relatório de privacidade a partir dele.

Próximas etapas

Agora que você configurou um projeto do Google Cloud, uma chave de API e um projeto do Xcode para usar com o SDK 3D do Maps para iOS, é possível Adicionar um mapa 3D ao seu app.