Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 1 addition & 35 deletions docs/examples/build-a-map.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,8 @@ description: create your own map
title: MapLibre
---

import CodeBlock from '@theme/CodeBlock';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import Map from '@site/src/components/map';
import {Admins, Buildings, Places, Transportation, Water, Landuse, Land} from '@site/src/components/layers.js';
import QueryBuilder from '@site/src/components/queryBuilder';
import SeattlePlaces from '!!raw-loader!@site/src/queries/duckdb/seattle_places_for_map.sql';
import SeattlePlacenames from '!!raw-loader!@site/src/queries/duckdb/seattle_placenames_for_map.sql';
Expand All @@ -17,10 +14,6 @@ import SeattleLand from '!!raw-loader!@site/src/queries/duckdb/seattle_land_for_
import SeattleLanduse from '!!raw-loader!@site/src/queries/duckdb/seattle_land_use_for_map.sql';
import SeattleWater from '!!raw-loader!@site/src/queries/duckdb/seattle_water_for_map.sql';



<Map></Map>

## Download and process only the data you need

Overture data is released in the cloud-native format [GeoParquet](https://geoparquet.org/). It is further partitioned by *theme* and *type*. Downloading the data through a tool like [DuckDB](https://duckdb.org/) can take advantage of these properties, giving the best performance. After downloading and converting the data to GeoJSON, we can use [tippecanoe](https://github.com/felt/tippecanoe) to create a [`PMTiles`](https://github.com/protomaps/PMTiles) archive for each theme.
Expand Down Expand Up @@ -200,7 +193,7 @@ At this point, we have created five PMTiles archives from five of the Overture t
4. `roads.pmtiles`
5. `base.pmtiles`

The map on this page combines a [react maplibre example](https://docs.maptiler.com/react/maplibre-gl-js/how-to-use-maplibre-gl-js/) with [PMTiles](https://codesandbox.io/s/black-dream-oycvf2?file=/src/App.js). You can [view the source](https://github.com/OvertureMaps/docs/blob/main/src/components/map.js) for the above map on github for a complete example using react, or, check out the [map based on July's release](https://labs.overturemaps.org/overture-with-daylight) for a non-react implementation of PMTiles.
Check out the [map based on the latest release](https://labs.overturemaps.org/overture-with-daylight) for a complete example of styling these archives with MapLibre and PMTiles.

Using PMTiles with react requires adding the [PMtiles protocol](https://docs.protomaps.com/pmtiles/maplibre):

Expand Down Expand Up @@ -234,30 +227,3 @@ Then, reference the tile archives with a relative path when initializing the map
},
...
```

## Style the layers
Each tab below contains the complete styles in the [Maplibre Style Spec](https://maplibre.org/maplibre-style-spec/) for the map on this page.

<Tabs queryString="map-layer" >
<TabItem value="places" label="Places" default>
<CodeBlock language="json">{ JSON.stringify(Places, null, 2) }</CodeBlock>
</TabItem>
<TabItem value="placenames" label="Placenames" default>
<CodeBlock language="json">{ JSON.stringify(Admins, null, 2) }</CodeBlock>
</TabItem>
<TabItem value="buildings" label="Buildings" default>
<CodeBlock language="json">{ JSON.stringify(Buildings, null, 2) }</CodeBlock>
</TabItem>
<TabItem value="roads" label="Roads" default>
<CodeBlock language="json">{ JSON.stringify(Transportation, null, 2) }</CodeBlock>
</TabItem>
<TabItem value="land" label="Land" default>
<CodeBlock language="json">{ JSON.stringify(Land, null, 2) }</CodeBlock>
</TabItem>
<TabItem value="landuse" label="Landuse" default>
<CodeBlock language="json">{ JSON.stringify(Landuse, null, 2) }</CodeBlock>
</TabItem>
<TabItem value="water" label="Water" default>
<CodeBlock language="json">{ JSON.stringify(Water, null, 2) }</CodeBlock>
</TabItem>
</Tabs>
4 changes: 2 additions & 2 deletions docs/getting-data/cloud-sources.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Overture distributes its core map data as [GeoParquet](https://geoparquet.org/)
| Amazon S3 | `s3://overturemaps-us-west-2/release/<RELEASE>` |
| Microsoft Azure | `https://overturemapswestus2.blob.core.windows.net/release/<RELEASE>` |

Find the latest `<RELEASE>` value in the [STAC catalog](https://stac.overturemaps.org/catalog.json) or the [STAC viewer](https://stac.overturemaps.org/). See the [quickstart](/getting-data/) for how to query the catalog programmatically.
Find the latest `<RELEASE>` value in the [STAC catalog](https://stac.overturemaps.org/catalog.json) or browse it with [stac-browser](https://browser.moregeo.it/external/stac.overturemaps.org/catalog.json). See the [quickstart](/getting-data/) for how to query the catalog programmatically.

### Path structure

Expand Down Expand Up @@ -82,7 +82,7 @@ Preview any PMTiles URL at [pmtiles.io](https://pmtiles.io). To create your own

## STAC catalog

Overture's [STAC catalog](https://stac.overturemaps.org/catalog.json) is the machine-readable index for all releases. It always points to the latest release and includes metadata for every theme and type: spatial extents, feature counts, column names, links to GeoParquet files on AWS and Azure, and links to PMTiles. Browse it in the [STAC viewer](https://stac.overturemaps.org/).
Overture's [STAC catalog](https://stac.overturemaps.org/catalog.json) is the machine-readable index for all releases. It always points to the latest release and includes metadata for every theme and type: spatial extents, feature counts, column names, links to GeoParquet files on AWS and Azure, and links to PMTiles. Browse it with [stac-browser](https://browser.moregeo.it/external/stac.overturemaps.org/catalog.json), since the raw JSON URL isn't a UI on its own.

## GERS registry, bridge files, and changelog

Expand Down
2 changes: 1 addition & 1 deletion docs/getting-data/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ SET VARIABLE latest = (
);
```

Browse all release artifacts in the [STAC viewer](https://stac.overturemaps.org/). The Python client uses the STAC catalog automatically.
Browse all release artifacts with [stac-browser](https://browser.moregeo.it/external/stac.overturemaps.org/catalog.json). The Python client uses the STAC catalog automatically.

## Next steps

Expand Down
Loading