Static Maps¶

Static maps are map images embedded in alert messages. This page covers advanced static map configuration. For basic setup, see Geocoding.

Custom Map Definitions¶

Custom map definitions allow you to create specialized map templates for different alert types. Place custom map JSON files in config/customMaps/.

Custom maps extend the built-in map types with additional markers, polygons, or multiple map views.

The tileserver settings control how maps are generated for each alert type:

[geocoding.tileserver_settings.default]
type = "staticMap"
width = 500
height = 250
zoom = 15
pregenerate = true
include_stops = false

Multi-static maps combine multiple map views (e.g. street view + satellite) into a single image:

[geocoding.tileserver_settings.monster]
type = "multiStaticMap"

When pregenerate = true, map tiles are pre-generated by the tileserver cache, reducing latency for alerts:

[geocoding.tileserver_settings.default]
pregenerate = true

Show nearby pokestops on the map:

[geocoding.tileserver_settings.monster]
include_stops = true

Configure different map styles for different times of day:

[geocoding]
day_style = "osm-bright"
dawn_style = "osm-liberty"
dusk_style = "osm-liberty"
night_style = "dark-matter"

Use the #(style) placeholder in your TileserverCache URL templates to automatically select the appropriate style.

Instead of linking to map images, Poracle can download and upload them directly to Discord's CDN:

[discord]
upload_embed_images = false

This can be useful if your tileserver is not publicly accessible.