Como conseguir 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 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:

• gcloud services api-keys create

Você vai precisar dessa chave de API ao criar seu projeto do Xcode, conforme descrito em Configurar um projeto do Xcode.

Observação:você pode usar a mesma chave de API nos seus apps do SDK do Maps para iOS e do SDK do Places para iOS.

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. Você é financeiramente responsável pelas cobranças causadas pelo abuso de chaves de API irrestritas. Para mais informações, consulte Práticas recomendadas de segurança de APIs.

Ao restringir uma chave de API no console do Cloud, as restrições do aplicativo substituem todas as APIs ativadas em Restrições da API. Siga as práticas recomendadas criando outra chave de API para cada app e plataforma em que o aplicativo estiver disponível.

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 informado, selecione a opção adequada 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, ele terá que ser ativado.
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 services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Defina novas restrições para as chaves atuais.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=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:

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud services api-keys list

Agora que você tem a 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 do Xcode conforme descrito em Configurar um projeto do Xcode.