Map Display

Primeiros passos

Importar a API Javascript

A API Javascript da Maplink está disponível publicamente na url https://maps.maplink.global, e pode ser incluída em qualquer página web facilmente com uma tag script:

<script src="https://maps.maplink.global"></script>

Criar objeto do mapa

Com a API já importada, tudo o que é necessário fazer para renderizar um mapa é definir um elemento div em sua página, e criar uma instância da classe MaplinkMap associada a este elemento.

O construtor da classe espera por dois argumentos obrigatórios: a chave de api da Maplink (client_id usada para autenticação das APIs), e o id do elemento div onde o mapa será renderizado.

<div id="map"></div>
<script>
const apiKey = "[CHAVE DE API]";
const maplink = new MaplinkMap(apiKey, "map");
</script>

Um terceiro argumento de configurações pode ser passado opcionalmente na construção do mapa. Este argumento deve ser um objeto, onde cada propriedade corresponde a uma definição de configuração.

As opções disponíveis são:

  • renderType – Aceita os valores string "pbf" e "png". Seleciona o formato em que os tiles do mapa serão enviados pelo servidor. Por padrão, o formato é o protobuf (pbf), que utiliza recurso de aceleração gráfica do navegador por meio da API WebGL. Em ambientes sem suporte a WebGL, é necessário que seja configurada a opção png, ou o mapa não poderá ser renderizado.
  • center – Um objeto de coordenada, definindo o ponto central na renderização inicial do mapa.
  • zoom – Um número que define o nível de zoom inicial. Este valor é repassado diretamente para a instância do leaflet associada ao mapa. Mais informações podem ser encontradas no link:  Zoom levels – Leaflet.