Adicionar PMTiles de protocolo personalizado

O SDK da Web do Azure Mapas dá suporte a protocolos personalizados, como PMTiles. O protocolo pmtiles:// é usado para referenciar arquivos PMTiles, que são formatos de arquivo único para armazenar dados em bloco, como mapas de vetor e varredura. Esse protocolo permite que o Azure Mapas acesse blocos específicos em um arquivo PMTiles usando uma solicitação HTTP, buscando apenas os dados necessários sob demanda.

Adicionar protocolo personalizado

Usando a função addProtocol, que registra um retorno de chamada disparado antes de qualquer solicitação AJAX feita pela biblioteca, você pode interceptar, modificar e retornar a solicitação de processamento e renderização adicionais. Isso permite a implementação de uma função de retorno de chamada personalizada para carregar recursos quando uma URL começa com o esquema personalizado designado.

A primeira etapa é adicionar uma referência ao protocolo. O exemplo a seguir faz referência à biblioteca pmtiles:

  <script src="https://unpkg.com/pmtiles@3.2.0/dist/pmtiles.js"></script>

Em seguida, inicialize o protocolo MapLibre PMTiles.

  //Initialize the plugin.
  const protocol = new pmtiles.Protocol();
  atlas.addProtocol("pmtiles", protocol.tile);

Adicionar PMTiles como uma fonte de mapa

O exemplo a seguir usa o conjunto de dados de criação de Abertura para adicionar dados de construção sobre o mapa base.

Os PMTiles são adicionados como uma fonte de mapa durante o evento de mapa. Depois de adicionado, o esquema de URI especificado está disponível para o SDK da Web do Azure Mapas. No exemplo a seguir, a URL pmtiles é adicionada como um VectorTileSource.

const PMTILES_URL = "https://overturemaps-tiles-us-west-2-beta.s3.amazonaws.com/2024-07-22/buildings.pmtiles";
//Add the source to the map.
map.sources.add(
  new atlas.source.VectorTileSource("my_source", {
    type: "vector",
    url: `pmtiles://${PMTILES_URL}`,
  })
);

Observação

O uso do protocolo pmtiles:// cria automaticamente as propriedades minzoom e maxzoom para a origem.

Aprimorar o mapa com dados de abertura

A abertura fornece um esquema de dados unificado e abrangente projetado para organizar e estruturar dados geoespaciais de forma eficaz. Esse esquema é dividido em temas diferentes, cada um representando um tipo específico de informações geoespaciais.

O exemplo a seguir usa as propriedades do tema do edifício (por exemplo, tipo e altura do edifício) para demonstrar a extrusão do edifício e diferenciar entre categorias de edifícios no mapa base, em vez de apenas mostrar as plantas dos edifícios.

//Create a polygon extrusion layer.
layer = new atlas.layer.PolygonExtrusionLayer(
  "my_source",
  "building",
  {
    sourceLayer: "building",
    height: ["get", "height"],
    fillOpacity: 0.5,
    fillColor: [
      "case",
      ['==', ['get', 'subtype'], 'agricultural'],
      "wheat",
      ['==', ['get', 'subtype'], 'civic'],
      "teal",
      ['==', ['get', 'subtype'], 'commercial'],
      "blue",
      ['==', ['get', 'subtype'], 'education'],
      "aqua",
      ['==', ['get', 'subtype'], 'entertainment'],
      "pink",
      ['==', ['get', 'subtype'], 'industrial'],
      "yellow",
      ['==', ['get', 'subtype'], 'medical'],
      "red",
      ['==', ['get', 'subtype'], 'military'],
      "darkgreen",
      ['==', ['get', 'subtype'], 'outbuilding'],
      "white",
      ['==', ['get', 'subtype'], 'religious'],
      "khaki",
      ['==', ['get', 'subtype'], 'residential'],
      "green",
      ['==', ['get', 'subtype'], 'service'],
      "gold",
      ['==', ['get', 'subtype'], 'transportation'],
      "orange",
      "grey",
    ],
    filter: ['any', ['==', ['geometry-type'], 'Polygon'], ['==', ['geometry-type'], 'MultiPolygon']]
  }
);

A imagem a seguir mostra uma captura de tela exibindo a extrusão de edifícios de diferentes tipos perto do Central Park, em Nova York.

Uma captura de tela demonstrando os pmtiles de protocolo personalizado.

Para obter um exemplo totalmente funcional com código-fonte, consulte o Repositório do GitHub de Exemplos do Azure Mapas.

Próximas etapas

Os seguintes artigos estão relacionados a PMTiles de protocolo personalizado: