System Constants
These are the fixed limits, ratios, and rendering parameters built into pitchmappr. They're not user-configurable but are documented here for reference and to explain the boundaries you may encounter while using the tool.
Limits
| Constant | Value | Description |
|---|---|---|
CFG.maxLocations | 1000 | Maximum total locations across all datasets in a single project. This limit exists to prevent performance issues (rendering, geocoding, exporting) with very large marker counts. Import operations check this limit before proceeding. If you need more than 1000 locations, consider splitting your data across multiple projects. |
CFG.maxImportNames | 200 | Maximum location names per batch import operation (the "One per line" import). This limits the geocoding API load per import to prevent rate limiting or timeouts. For larger imports, run multiple batches or use CSV import with pre-geocoded coordinates (latitude/longitude columns). |
| Min datasets | 1 | At least one dataset must always exist in a project. The delete button is automatically hidden when only one dataset remains. This ensures there's always a group available for new locations. |
| Max HQ | 1 | Only one location can be marked as HQ at any time across the entire project. Setting a new location as HQ automatically clears the HQ status from the previous one. This constraint ensures there's always a single, unambiguous headquarters marker. |
Crop Ratios
These are the available aspect ratios for saved views and export framing. Each ratio determines the shape of the export crop frame.
| ID | Name | Aspect | Description |
|---|---|---|---|
16x9 | 16:9 | 1.78:1 | Standard widescreen aspect ratio. Matches PowerPoint (widescreen), Keynote, Google Slides, and most modern presentation templates. The most commonly used export format for business presentations. |
4x3 | 4:3 | 1.33:1 | Standard (legacy) slide format. Used by older presentation templates and some print layouts. Also matches many traditional document insert dimensions. |
1x1 | 1:1 | 1:1 | Square format. Useful for social media posts, profile images, balanced compositions, and situations where the output needs to be symmetrical. |
letter | Letter | 1.29:1 | US Letter landscape (11" x 8.5"). Matches standard North American print paper in landscape orientation. Use this when your export will be printed on standard paper or inserted into a letter-format document. |
a4 | A4 | 1.41:1 | A4 landscape (297mm x 210mm). Matches standard international print paper in landscape orientation. Use this for maps destined for non-US print output. |
Marker Rendering
These parameters control how markers are rendered on screen and in exports. They're not directly configurable but explain the base values that the user-accessible size multipliers act upon.
| Property | Value | Description |
|---|---|---|
| Base radius (live) | 9px | On-screen marker radius before any scaling is applied. This is the base size that markerScale multiplies. At the default 1.0x scale, markers are 9px radius on screen. |
| Base radius (export) | 11px | Export marker radius before scaling. Slightly larger than the screen radius to ensure markers remain visible and proportional in printed output and high-resolution exports. |
| Border width | 22% of radius | White stroke width when markerBorder is enabled. Calculated as a proportion of the marker radius so that borders look consistent and balanced at any marker size. |
| Shapes | circle, square, star | The three available marker shapes. Circle is a filled circle, square is a 45-degree rotated diamond (not an upright square), star is a 5-pointed star. All are rendered as SVG paths for sharp rendering at any size. |
| Shield base text-size | 8px | Default text size for highway shield route numbers. Multiplied by the shield text size setting. |
| Shield base icon-size | 0.8 | Default icon scale for shield badge graphics. Multiplied by the shield icon size setting. |
Base Flavor Map
This table maps pitchmappr's internal theme keys to the underlying Protomaps flavor names. It's primarily relevant for theme developers and for understanding how the theme system works internally.
| UI Key | Protomaps Flavor | Label | Description |
|---|---|---|---|
voyager | light | Light — warm, detailed | Full-color warm palette with terrain detail. The default and most feature-rich flavor. |
positron | white | White — clean, minimal | Bright white base optimized for data visualization. Minimal visual weight. |
light | grayscale | Grayscale — neutral | Monochrome grey palette. Neutral, non-distracting background for data-focused maps. |
dark | dark | Dark | Inverted dark palette for dark-themed presentations. Light roads and labels on dark background. |
black | black | Black — high contrast | Very dark data-viz palette (earth #141414). Maximum contrast for dramatic presentations. |