Guia de início rápido da API Maps Embed

Coloque um mapa interativo ou um panorama do Street View na sua página da Web com uma solicitação HTTP, sem precisar de JavaScript personalizado.

Custos

Todas as solicitações de API do Maps Embed estão disponíveis sem custos financeiros com uso ilimitado. No entanto, todas as solicitações ainda exigem uma chave de API válida do Google Cloud. Para mais informações, consulte Uso e faturamento.

Antes de começar

Para criar um mapa incorporado na sua página da Web, siga estas etapas de configuração:

Etapa 1: configurar o projeto

Console

  1. No console do Google Cloud, mais especificamente na página do seletor de projetos, clique em Criar projeto para elaborar 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: ativar APIs ou SDKs

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

Console

Ativar a API Maps Embed

SDK do Cloud

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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

Etapa 3: gerar uma chave de API

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 nova chave ou adicionar uma API ou um SDK a uma chave, siga estas instruções.

Console

  1. Acesse a página Plataforma Google Maps > Chaves e credenciais.

    Acessar a página Chaves e credenciais

  2. Se solicitado, selecione o projeto.

  3. Escolha uma destas opções:

    • Crie uma nova chave:

      1. Clique em Criar credenciais > Chave de API.
      2. No painel Criar chave de API, abra a lista Selecionar restrições de API.
      3. Limpe as APIs que essa chave não precisa e verifique se a API Maps Embed permanece selecionada.
      4. Clique em Criar. O painel mostra sua nova chave de API.

    • Usar uma chave atual:

      1. Clique no nome da chave.
      2. Na lista Selecionar restrições da API, escolha API Maps Embed.
      3. Clique em Salvar.

    Selecionar uma API aqui não a ativa. Verifique se a API Maps Embed está ativada na página da biblioteca de APIs.

  4. Para ver a string da chave mais tarde, acesse a página Chaves e credenciais e clique em Mostrar chave.

Se o console estiver diferente do que é mostrado nestas etapas, consulte Criar uma chave de API e Adicionar restrições de API na documentação do Google Cloud.

SDK do Cloud

Substitua PROJECT_ID pelo ID do projeto nos comandos a seguir.

  • Crie uma nova chave: execute o comando a seguir e substitua DISPLAY_NAME por um nome para a chave. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=maps-embed-backend.googleapis.com

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

  • Usar uma chave atual: execute o comando a seguir e substitua KEY_ID pelo ID da chave. A flag --append mantém as APIs que a chave já permite. Sem ele, o comando as substitui.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=maps-embed-backend.googleapis.com

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

    O ID da chave não é a string de chave nem o nome de exibição. Para encontrá-lo, execute gcloud services api-keys list --project="PROJECT_ID". O ID é a última parte do campo name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Para ver a string de chave, execute gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Como gerar um iframe

Clique nas opções a seguir e adicione um local e uma chave de API para gerar um iframe para sua página da Web. Para mais parâmetros e opções, consulte Como incorporar um mapa.

Como testar o iframe

Para ver o iframe em uma janela do navegador HTML:

  1. Abra o editor de texto padrão. Por padrão, seu dispositivo já deve ter editores de texto instalados, como o TextEdit ou o Bloco de Notas do Microsoft Windows.
  2. Crie um arquivo HTML e nomeie-o como index.html.

  3. Adicione o código abaixo com o iframe que você gerou acima:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. Salve o arquivo HTML index.html.

  5. Carregue o arquivo HTML, arrastando da área de trabalho para o navegador da web. Na maioria dos sistemas operacionais, você também pode clicar duas vezes no arquivo.

Parabéns! Você acabou de configurar e criar um mapa usando a API Maps Embed.

Limpar

É possível excluir seu projeto do Google Cloud para interromper o faturamento de todos os recursos usados nele.

  1. No Console do Google Cloud, acesse a página Gerenciar recursos.

    Acessar a página Gerenciar recursos

  2. Se o projeto que você planeja excluir estiver anexado a uma organização, selecione e expanda a lista de organizações na parte de cima da página.
  3. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir.
  4. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Próximas etapas