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

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

Custos

Todas as solicitações da API Maps Embed estão disponíveis sem custos financeiros com uso ilimitado. No entanto, todas as solicitações ainda exigem uma chave válida da API 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, 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 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 a página da Web. Para parâmetros e opções adicionais, consulte Como incorporar um mapa.

Como testar seu iframe

Para ver o iframe em uma janela do navegador HTML:

  1. Abra o editor de texto padrão. Por padrão, você precisa ter editores de texto como o TextEdit ou o Microsoft Windows Notepad instalados no seu dispositivo.
  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 em um navegador da Web arrastando-o da área de trabalho para o navegador. Na maioria dos sistemas operacionais, você também pode clicar duas vezes no arquivo.

Parabéns! Basta configurar e criar um mapa usando a API Maps Embed.

Limpar

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