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 simples. Não é necessário usar 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 válida do Google Cloud. Para mais informações, consulte Utilização 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 guias a seguir:

Etapa 1

Console

  1. No console do Google Cloud, na página do seletor de projetos, clique Criar projeto para começar a criar 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 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 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 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:

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

Testar o iframe

Para conferir o iframe em uma janela do navegador HTML:

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

  3. Adicione o código a seguir 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, arrastando da área de trabalho para o navegador. 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 um e clique em Excluir.
  4. Na caixa de diálogo, digite o ID do projeto e clique em desligar para excluir o projeto.

Próximas etapas