Como obter uma chave de API

Selecione a plataforma: Android iOS JavaScript

Agora que você configurou o faturamento e um projeto, ativou o SDK e instalou o gerenciador de dependências e outros softwares, está tudo pronto para criar, adicionar e restringir sua chave de API.

Criar chaves de API

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 alpha 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:

Você precisa dessa chave de API para criar seu projeto Xcode conforme descrito em Configure um projeto do Xcode.

Restringir chaves de API

O Google recomenda que você restrinja as chaves de API limitando o uso somente às APIs necessárias para o aplicativo. Isso deixa o app mais seguro, protegendo contra solicitações não autorizadas. Para mais informações, consulte Práticas recomendadas de segurança de APIs.

Para restringir uma chave de API, faça o seguinte:

Console

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

    Acessar a página "Credenciais"

  2. Selecione a chave de API em que você quer definir uma restrição. A página de propriedades será exibida.
  3. Em Restrições de chave, defina as seguintes opções:
    • Restrições do aplicativo:
      1. Selecione Apps iOS.
      2. Para aceitar solicitações do app iOS com o identificador do pacote que você fornecer, selecione o identificador do pacote iOS adequado na lista.
    • Restrições de API:
      1. Clique em Restringir chave.
      2. Escolha SDK do Maps para iOS da lista suspensa Selecionar APIs. Se o SDK do Maps para iOS não aparecer na lista, você precisará: ativá-la.
  4. Para concluir as mudanças, clique em Salvar.

SDK Cloud

Liste as chaves atuais.

gcloud services api-keys list --project="PROJECT"

Limpe as restrições atuais na chave.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Defina novas restrições para as chaves atuais.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

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

Agora que você adquiriu sua chave de API do SDK do Maps para iOS, está tudo pronto para começar.

A seguir

Agora que você tem uma chave de API, crie e configure seu projeto Xcode como descrito em Configurar um projeto do Xcode.