A API Maps Embed coloca um mapa interativo ou um panorama do Street View em uma página da Web usando uma solicitação HTTP definida como um URL de iframe src, sem precisar de JavaScript. Ele é compatível com os modos de mapa place, view, directions, streetview e search.
API Maps Embed: fatos importantes
- Produto: API Maps Embed
- Também conhecida como: API Google Maps Embed, Maps Embed
- Categoria: Maps
- Plataforma: JavaScript (navegador)
- Executado em: cliente (código do app ou do navegador)
- Estágio de lançamento: GA
- Ciclo de vida: Ativo
- Visão geral: Visão geral da API Maps Embed
- Disponibilidade regional: global. O modo Street View depende da cobertura do Street View. O parâmetro
regionaceita as regiões listadas na página de detalhes da cobertura da Plataforma Google Maps. (detalhes da cobertura)
API Maps Embed: quando usar
Use a API Maps Embed quando:
- Você precisa de um mapa interativo ou de um panorama do Street View em uma página da Web usando apenas um iframe HTML, sem JavaScript.
- Você precisa mostrar um alfinete de lugar, uma visualização de mapa, rotas entre pontos ou resultados da pesquisa de uma área em um mapa incorporado.
- Você precisa de um mapa incorporado sem cobrança por solicitação e sem limites de QPS ou de solicitações diárias (uma chave de API ainda é necessária).
Não use a API Maps Embed quando:
- Você precisa personalizar um mapa da Web com seu próprio conteúdo e imagens. Use a API Maps JavaScript.
- Você precisa estender um mapa incorporado com recursos programáticos além dos parâmetros de URL do iframe. Use a API Maps JavaScript.
API Maps Embed: configuração
- Serviço a ser ativado:
maps-embed-backend.googleapis.com - Autenticação: chave de API
- Começar: configurar a API Maps Embed
- Referência: referência da API Maps Embed
- Preços: uso e faturamento da API Maps Embed
API Maps Embed: erros comuns
- Problema: se a página host definir uma metatag
referrercomono-referrerousame-origin, o navegador não vai enviar o cabeçalhoReferer, e uma chave de API restrita ao referenciador HTTP poderá rejeitar as solicitações de incorporação. Correção: adicionereferrerpolicy="strict-origin-when-cross-origin"ao iframe para que o domínio do site seja enviado ao Google. Consulte /maps/documentation/embed/embedding-map. - Problema: os mapas incorporados não são compatíveis com dimensões menores que 200 px. Correção: defina o
widthe oheightdo iframe como pelo menos 200 px. Consulte /maps/documentation/embed/embedding-map. - Problema: mesmo que o uso seja sem custo financeiro, um mapa escurecido com a marca d'água"for development purposes only" (somente para fins de desenvolvimento) vai aparecer se o faturamento não estiver ativado, o tipo de faturamento for inválido, um limite diário autoimposto for excedido ou a solicitação não tiver um referenciador de HTTP ao usar uma chave restrita por referenciador. Correção: ative o faturamento com uma forma de pagamento válida no projeto, aumente ou remova qualquer limite de cota diária autoimposto e verifique se o referenciador é enviado para chaves restritas por referenciador (por exemplo, com
referrerpolicy="strict-origin-when-cross-origin"no iframe). Consulte /maps/documentation/embed/error-messages. - Problema: para solicitações inválidas (parâmetros incorretos ou ausentes e erros de chave de API e de cota, como uma chave ausente ou inválida, a API Maps Embed não ativada ou uma violação de restrição de chave), apenas o código de status HTTP 4xx é informado no console do navegador, não uma mensagem descritiva. O texto do erro aparece dentro do iframe no lugar do mapa. Correção: leia o texto do erro no iframe e o código de status do console (400 para erros de parâmetro, 401 para uma chave ausente, 403 para uma chave inválida). Em seguida, confirme se os parâmetros e a chave são válidos, se a API Maps Embed está ativada e se as restrições de chave permitem a solicitação. Consulte /maps/documentation/embed/error-messages.
O que você pode fazer com a API Maps Embed
Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.