Incorporar um mapa no seu site

Um mapa incorporado coloca um dos seus projetos dentro de uma página do seu próprio site: as suas formas, as medições e, se tiver preços, a estimativa. Os visitantes veem-no ali mesmo, sem conta, e podem abri-lo no Measure Map Online se quiserem mais espaço.

Que projetos podem ser incorporados#

O que os visitantes do seu site veem depende do nível de acesso do projeto:

• Os projetos visibilitySomente visualização e publicPúblico aparecem na sua página. Os visitantes podem ver mas não alterar nada: a edição está desativada dentro de um mapa incorporado, mesmo para os membros do projeto.
• Os projetos person_pin_circleConvidado Aberto são a exceção: os visitantes podem medir neles e pedir-lhe uma estimativa.
• Os projetos lockPrivado não abrem para os seus visitantes.

Defina o nível de acesso do projeto nas suas definições de partilha antes de o incorporar.

Obter o código de incorporação#

1. No painel, prima codeDeveloper e depois web_assetIncorporar um mapa. A incorporação usa sempre a sua chave de produção: os visitantes do seu site não conseguem abrir projetos criados com uma chave de testes (consulte produção e testes).
2. Em Obtenha sua chave API iFrame, se a página ainda não mostrar nenhuma chave, prima addGerar nova chave. Consulte chaves de API.
3. Em Definir o ID do projeto, escreva parte do nome do projeto em Projeto e escolha-o na lista. A lista indica como cada projeto está partilhado e deixa de fora os modelos e os projetos da reciclagem. Se escolher um projeto Privado, a página avisa que os seus visitantes não o conseguem abrir e oferece visibilityMudar para «Somente visualização».
4. Em Incorporar código, escolha o aspeto do mapa:
   • Tema: Automático segue a definição de claro ou escuro de cada visitante; ou sempre Claro ou Escuro.
   • Unidades: Automático (país do visitante) mostra unidades imperiais aos visitantes dos Estados Unidos e métricas a todos os outros; ou sempre Imperial ou Métrico.
   • Tipo de mapa: Satélite, Mapa, Híbrido ou Terreno.
   • Largura e Altura do mapa na sua página, em píxeis (200 a 2000).
5. Verifique a Pré-visualização ao vivo.
6. Prima content_copy ao lado de Código de incorporação e cole o código no HTML da sua página, onde o mapa deve aparecer.

O código contém a sua chave de API, por isso o mapa continua a funcionar até substituir a chave, nos sites que a chave permite. Depois de a substituir, a chave antiga continua a ser aceite durante 24 horas: cole o novo código nas suas páginas dentro desse prazo. Só a Pré-visualização ao vivo desta página usa, em vez disso, um token de curta duração.

Para manter a chave totalmente fora das suas páginas, faça com que o servidor do seu site peça um token sempre que a página é mostrada. Consulte chave ou token, que também lista todas as definições que o endereço de incorporação aceita.

Restringir o mapa aos seus sites#

Por predefinição, uma incorporação funciona em qualquer site. Para impedir que outros sites mostrem os seus mapas, prima codeDeveloper > vpn_keyChaves de API e acrescente os seus próprios sites, como example.com, em Restrições do site. Um site da lista abrange também os seus subdomínios. Quando a lista tem pelo menos um site, um mapa incorporado em qualquer outro sítio não abre. Consulte restringir a chave aos seus sites.

O que os visitantes podem fazer#

Num mapa incorporado, os visitantes podem:

• deslocar-se e aproximar o mapa, e clicar numa forma para ler as suas medições;
• ver a estimativa do projeto, quando existe;
• premir settings para mudar o tipo de mapa e as unidades de medida (consulte definições);
• premir o botão do Measure Map Online no canto inferior direito para abrir o projeto num novo separador.

Num projeto do Open Guest também podem desenhar e medir, e premir Pedir orçamento para lhe enviar os seus dados.

Em todos os outros mapas incorporados não é possível editar, nem sequer para os membros do projeto. Para criar a incorporação a partir do seu próprio código, ou para lhe pôr um token de curta duração em vez da sua chave, consulte a API iFrame.