Urlmaps are the easiest way to get beautiful maps using just a url. Compose the url for the map you want and get an image (png) in return.
This type of map is called a colored map, or by its scientific name, a choropleth. These maps can be used for whatever purpose you like, for example to embed beautiful (static) maps in:
- a web page
- an e-mail message or newsletter
- a PDF
- a Word document
- a marketing campaign
- a dashboard
The urls consist of the base url https://urlmaps.com/ followed by the id of the map and (optional) params to define the map. All params are optional.
These urlmaps are heavily inspired by Image-Charts, a super-easy way of creating image charts.
If you don't believe it can be that easy, copy any of the example links from this page into your browser url bar, play around with the params and be amazed!
The simplest example is a plain map. In this case: the map of 48 US States with all the default settings.
Map dimensions determine the dimensions of the image that is returned. Dimensions are specified using the s-param. The format is [width]x[height] in pixels.
|s||600x400||dimensions||[width]x[height] in pixels (max 900x900)||s=640x480|
|a||area specs||area specs, separated by | (pipe)||a=nl:20|de:25|be:30|
|bg||aadaff||map background color||color code||bg=aadaff|
|ls||0.3||line size||floating point||ls=1|
|c||color||one color to fill areas||c=f07763|
|cp||color palette||one or more colors separated by , (comma)||cp=fff,000|
|rmp||color ramp||ramp start (optional) / end separated by , (comma)|
|dl||show data labels||dl=1|
|lf||label font||0: Frutiger|
2: Courier New
6: Times New Roman
7: Trebuchet MS
|lfs||label font size||lfs=20|
|lfc||label font color||lfc=fff|
Area specs (a) supported formats
The a-param contains area specs, separated by | (pipe). However, the area spec may contain additional information about the area, e.g. color info or data value and label.
|[area code]||display the area||nl|de|be|
|[area code]:[code]||display area and use [code] for coloring||nl:20|de:25|be:30|
|[area code]:[code]:[label]||same, but with area-specific label||nl:20:Netherlands|de:25:Germany|be:30:Belgium|
By default, urlmaps are zoomed to fit the areas that are provided in the data (a-param). By using the nz-param the map can be forced to display in full.
Urlmaps support multiple ways of defining colors and linking colors to areas on the map:
- By providing a color per area in the a-param
- By using a color palette, using the cp-param
- By using a color ramp (rmp-param), automagically calculating colors for area data
Color codes are hexadecimal codes in RRGGBB-format.
Providing a color per area
Use this method to provide a handpicked color for specific areas.
Specify each color in the a-param with the area.
Using a color palette
Use a palette to fill areas on the map with colors from a preselected set of colors.
Provide the color palette using the cp-param. The colors in the palette should be comma-separated. Areas in the data get an index number that assigns them a color from the palette.
The nz-param disables zooming the colored areas (default).
Using a color ramp
Urlmaps supports two models:
Community Version (free)
- Unlimited map generation
- Community support
Pro Version (€ 29 / month)
- Unlimited map generation
- Priority support
- Input on roadmap
- No watermark
Contact email@example.com to obtain a pro subscription.