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

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

Custos

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

Antes de começar

Para criar um mapa incorporado na sua página da Web, conclua as etapas de configuração necessárias clicando nas seguintes guias:

Etapa 1

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. A Plataforma Google Maps disponibiliza um crédito mensal recorrente de US$ 200. Para mais informações, consulte Créditos da conta de faturamento e Faturamento.

SDK 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.

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

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

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 Inserir um mapa.

Testar o iframe

Para ver o iframe em uma janela de navegador HTML:

  1. Abra o editor de texto padrão. Você precisa ter editores de texto, como TextEdit ou Microsoft Windows Notepad, instalados no dispositivo por padrão.
  2. Crie um arquivo HTML e nomeie-o como index.html.

  3. Adicione o código abaixo com o iframe gerado acima:

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

  4. Salve o arquivo HTML index.html.

  5. Carregue o arquivo HTML em um navegador da Web arrastando-o da área de trabalho para o navegador. Como alternativa, clicar duas vezes no arquivo funciona na maioria dos sistemas operacionais.

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

Limpar

Você pode excluir seu projeto do Google Cloud para interromper o faturamento de todos os recursos usados nesse projeto.

  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 superior da página.
  3. Na lista de projetos, selecione o que você quer excluir e clique em Excluir.
  4. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluir o projeto.

Próximas etapas