Choosing a Tile Provider
Pigeon Maps defaults to loading map tiles from OpenStreetMap.org. While free (thanks to volunteers and donations), these OSM tiles aren't the best looking visually.
Usually you want to specify a custom map tile provider. There are many commercial tile servers to choose from and you can even set up your own.
#
Using a custom tile providerTo specify your own provider, create a function with the signature (x: number, y: number, z: number, dpr?: number) => string
which
returns the URL of the tile.
One nice provider is MapTiler. Their maps look good and their free plan provides up to 100k tile loads per month. You will need to sign up for an account and pass your API key and map id to the following provider
#
Included providersPigeon Maps comes with a few providers you can import
and use directly.
#
osmThis is the default provider. Free and supported by donations. Does not support HiDPI/retina tiles.
#
stamenTerrainOrient yourself with our terrain maps, featuring hill shading and natural vegetation colors. These maps showcase advanced labeling and linework generalization of dual-carriageway roads.
#
stamenTonerThese high-contrast B+W (black and white) maps are perfect for data mashups and exploring river meanders and coastal zones.
#
maptilerNice looking commercial maps from MapTiler. You get 100k tiles for free, so it's a no-brainer for websites with limited traffic.
Pass the API key and the basemap type (e.g. streets
, basic
, topo
, etc) to the imported function.