Pmtiles

PMTiles source and protocol

This source code of this example is adapted from the MapLibre GL JS example - mPMTiles source and protocol.

Uncomment the following line to install leafmap if needed.

In [ ]:

# %pip install -U "leafmap[maplibre]"

# %pip install -U "leafmap[maplibre]"

In [ ]:

import leafmap.maplibregl as leafmap

import leafmap.maplibregl as leafmap

Remote PMTiles¶

Source Cooperative¶

Google-Microsoft Open Buildings - combined by VIDA

In [ ]:

url = "https://data.source.coop/vida/google-microsoft-open-buildings/pmtiles/go_ms_building_footprints.pmtiles"
metadata = leafmap.pmtiles_metadata(url)
print(f"layer names: {metadata['layer_names']}")
print(f"bounds: {metadata['bounds']}")

url = "https://data.source.coop/vida/google-microsoft-open-buildings/pmtiles/go_ms_building_footprints.pmtiles" metadata = leafmap.pmtiles_metadata(url) print(f"layer names: {metadata['layer_names']}") print(f"bounds: {metadata['bounds']}")

In [ ]:

m = leafmap.Map(center=[0, 20], zoom=2, height="600px")
m.add_basemap("Esri.WorldImagery", visible=False)

style = {
    "version": 8,
    "sources": {
        "example_source": {
            "type": "vector",
            "url": "pmtiles://" + url,
            "attribution": "PMTiles",
        }
    },
    "layers": [
        {
            "id": "buildings",
            "source": "example_source",
            "source-layer": "building_footprints",
            "type": "fill",
            "paint": {"fill-color": "#3388ff", "fill-opacity": 0.5},
        },
    ],
}

# style = leafmap.pmtiles_style(url)  # Use default style

m.add_pmtiles(
    url,
    style=style,
    visible=True,
    opacity=1.0,
    tooltip=True,
)
m

m = leafmap.Map(center=[0, 20], zoom=2, height="600px") m.add_basemap("Esri.WorldImagery", visible=False) style = { "version": 8, "sources": { "example_source": { "type": "vector", "url": "pmtiles://" + url, "attribution": "PMTiles", } }, "layers": [ { "id": "buildings", "source": "example_source", "source-layer": "building_footprints", "type": "fill", "paint": {"fill-color": "#3388ff", "fill-opacity": 0.5}, }, ], } # style = leafmap.pmtiles_style(url) # Use default style m.add_pmtiles( url, style=style, visible=True, opacity=1.0, tooltip=True, ) m

In [ ]:

m.layer_interact()

m.layer_interact()

Local PMTiles¶

tippecanoe is required to convert vector data to pmtiles. Install it with conda install -c conda-forge tippecanoe.

Download building footprints of Derna, Libya.

In [ ]:

url = "https://raw.githubusercontent.com/opengeos/open-data/main/datasets/libya/Derna_buildings.geojson"
leafmap.download_file(url, "buildings.geojson")

url = "https://raw.githubusercontent.com/opengeos/open-data/main/datasets/libya/Derna_buildings.geojson" leafmap.download_file(url, "buildings.geojson")

Convert vector to PMTiles.

In [ ]:

pmtiles = "buildings.pmtiles"
leafmap.geojson_to_pmtiles(
    "buildings.geojson", pmtiles, layer_name="buildings", overwrite=True, quiet=True
)

pmtiles = "buildings.pmtiles" leafmap.geojson_to_pmtiles( "buildings.geojson", pmtiles, layer_name="buildings", overwrite=True, quiet=True )

Start a HTTP Sever

In [ ]:

leafmap.start_server(port=8000)

leafmap.start_server(port=8000)

In [ ]:

url = f"http://127.0.0.1:8000/{pmtiles}"
# leafmap.pmtiles_metadata(url)

url = f"http://127.0.0.1:8000/{pmtiles}" # leafmap.pmtiles_metadata(url)

Display the PMTiles on the map.

In [ ]:

m = leafmap.Map()
m.add_basemap("Esri.WorldImagery")
style = {
    "version": 8,
    "sources": {
        "example_source": {
            "type": "vector",
            "url": "pmtiles://" + url,
            "attribution": "PMTiles",
        }
    },
    "layers": [
        {
            "id": "buildings",
            "source": "example_source",
            "source-layer": "buildings",
            "type": "fill",
            "paint": {"fill-color": "#3388ff", "fill-opacity": 0.5},
        },
    ],
}

# style = leafmap.pmtiles_style(url)  # Use default style

m.add_pmtiles(
    url,
    style=style,
    visible=True,
    opacity=0.8,
    tooltip=True,
)
m

m = leafmap.Map() m.add_basemap("Esri.WorldImagery") style = { "version": 8, "sources": { "example_source": { "type": "vector", "url": "pmtiles://" + url, "attribution": "PMTiles", } }, "layers": [ { "id": "buildings", "source": "example_source", "source-layer": "buildings", "type": "fill", "paint": {"fill-color": "#3388ff", "fill-opacity": 0.5}, }, ], } # style = leafmap.pmtiles_style(url) # Use default style m.add_pmtiles( url, style=style, visible=True, opacity=0.8, tooltip=True, ) m

In [ ]:

m.layer_interact()

m.layer_interact()