Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ative o Google Maps SDK for iOS

Para começar, orientaremos você pelo Google Developers Console para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ative o Google Maps SDK for iOS
  3. Criar chaves apropriadas
Continuar

Obter chave de API

Para usar a Google Maps SDK for iOS, é necessário registrar o projeto do aplicativo no Google API Console e obter uma chave de API do Google para adicioná-la ao aplicativo. Observação: Há vários tipos de restrições de chaves de API. Você precisa de uma chave de API com restrição ao iOS (não uma chave com restrição a navegador).

Visão geral

Para autenticar o aplicativo com o Google Maps SDK for iOS, você precisa de uma chave de API restrita a um identificador de pacote de aplicativo específico. Essa combinação cria uma chave de API restrita ao iOS.

Obter uma chave de API no Google API Console

O uso de uma chave de API permite o monitoramento do uso de APIs pelo aplicativo e garante que o Google possa entrar em contato com você sobre o aplicativo, se necessário. A chave é gratuita, você pode usar a mesma chave com qualquer um dos aplicativos para iOS, e ela tem suporte para um número ilimitado de usuários. Você obtém uma chave de API no Google API Console e restringe a chave de API fornecendo o identificador de pacote do aplicativo.

Se você estiver usando o Google Maps SDK for iOS padrão:

Clique no botão abaixo para acessar um guia do processo de ativação do Google Maps SDK for iOS e obtenção de uma chave de API. Se o seu projeto já tem uma chave de API restrita ao iOS, você use-a.

Obter uma chave

Como alternativa, siga as etapas a seguir para obter uma chave de API:

  1. Acesse o Google API Console.
  2. Crie ou selecione um projeto.
  3. Clique em Continue para ativar o Google Maps SDK for iOS.
  4. Na página Credentials, obtenha uma chave de API.
    Observação: Se você tem uma chave restrita ao iOS, use-a. É possível usar a mesma chave com todos os aplicativos iOS dentro do mesmo projeto.
  5. Na caixa de diálogo que exibe a chave de API, selecione Restrict key para adicionar uma restrição para iOS à chave de API.
  6. Na seção Restrictions, selecione iOS apps e digite o identificador geral do seu aplicativo. Por exemplo: com.example.hellomap.
  7. Clique em Save.

    A nova chave de API restrita ao iOS aparece na lista de chaves de API do projeto. Uma chave de API é uma string de caracteres, similar a:

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Também é possível procurar uma chave existente no Google API Console.

Para saber mais sobre como usar o Google API Console, consulte a Ajuda do API Console.

Se você comprou uma licença do Google Maps APIs Premium Plan:

Clique no botão abaixo para acessar um guia do processo de obtenção de uma chave de API. Se o seu projeto já tem uma chave de API restrita ao iOS, use-a. Importante: no menu suspenso Project, você deve selecionar o projeto criado quando comprou o Google Maps APIs Premium Plan. O nome do projeto é iniciado por Google Maps APIs for Business or Google Maps for Work or Google Maps.

Obter uma chave

Como alternativa, siga as etapas a seguir para obter uma chave de API:

  1. Acesse o Google API Console.
  2. No menu suspenso Project, selecione o projeto do Google Maps Premium.*
  3. Clique em Continue.
  4. Na página Credentials, obtenha uma chave de API.
    Observação: Se você tem uma chave restrita ao iOS, use-a. É possível usar a mesma chave com todos os aplicativos iOS dentro do mesmo projeto.
  5. Na caixa de diálogo que exibe a chave de API, selecione Restrict key para adicionar uma restrição para iOS à chave de API.
  6. Na seção Restrictions, selecione iOS apps e digite o identificador geral do seu aplicativo. Por exemplo: com.example.hellomap.
  7. Clique em Save.

    A nova chave de API restrita ao iOS aparece na lista de chaves de API do projeto. Uma chave de API é uma string de caracteres, similar a:

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Também é possível procurar uma chave existente no Google API Console.

Para saber mais sobre como usar o Google API Console, consulte a Ajuda do API Console.

Tipos de restrição da chave de API

As Google Maps APIs estão disponíveis para aplicativos Android e iOS, navegadores e via serviços Web HTTP. APIs de qualquer plataforma podem usar uma chave de API genérica (irrestrita). Você tem a opção de adicionar uma restrição (por exemplo, identificador de pacote do iOS) à chave de API. Depois de aplicar a restrição, a chave só funcionará em plataformas compatíveis com esse tipo de restrição. Saiba mais sobre chaves e credenciais.

Adicionar a chave de API ao aplicativo

Swift

Adicione a chave de API a AppDelegate.swift da seguinte maneira:

  1. Adicione a seguinte declaração import:
    import GoogleMaps
  2. Adicione o seguinte ao método application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY por sua chave de API:
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Se você também usa a Places API, adicione a chave novamente da seguinte forma:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Adicione a chave de API a AppDelegate.m da seguinte maneira:

  1. Adicione a seguinte declaração import:
    @import GoogleMaps;
  2. Adicione o seguinte ao método application:didFinishLaunchingWithOptions:, substituindo YOUR_API_KEY por sua chave de API:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Se você também usa a Places API, adicione a chave novamente da seguinte forma:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Enviar comentários sobre…

Google Maps SDK for iOS
Google Maps SDK for iOS
Precisa de ajuda? Acesse nossa página de suporte.