Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the map centre."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the map centre."
},
"mat": {
"type": "boolean",
"description": "Gallery-style mat (passe-partout) around the map."
},
"size": {
"enum": [
"poster_portrait",
"poster_landscape",
"square",
"instagram_portrait",
"story",
"pinterest",
"desktop_wallpaper",
"a4",
"a3",
"a2",
"18x24in"
],
"type": "string",
"description": "Canvas size preset: poster_portrait (1080×1527), poster_landscape (1527×1080), square (1080×1080), instagram_portrait (1080×1350), story (1080×1920), pinterest (1000×1500), desktop_wallpaper (1920×1080), a4 (2480×3508), a3 (3508×4961), a2 (4961×7016), 18x24in (5400×7200). Default poster_portrait."
},
"zoom": {
"type": "number",
"maximum": 20,
"minimum": 1,
"description": "Zoom: ~11 metro area, 13 city, 15 neighbourhood, 16-17 a few streets. Default: the suggested zoom for the place."
},
"place": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "The place the user wants on the poster, e.g. \"Utrecht\" or \"Brooklyn, New York\". Used when lat/lon are not given (first search match)."
},
"route": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"via": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 10
},
"start": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
}
},
"description": "A route along the roads (driving directions) from start to end, through up to 10 via points: a road trip, or a road race such as a marathon, traced through points along its course."
},
"shape": {
"enum": [
"rectangle",
"circle",
"hexagon",
"heart"
],
"type": "string",
"description": "Map shape (default rectangle); circle, hexagon and heart make the canvas square."
},
"theme": {
"enum": [
"ancient_woodland",
"arctic_frost",
"arid_canyon",
"aurora_glow",
"autumn_whisper",
"blueprint_classic",
"charcoal_sketch",
"copper_patina",
"cyber_glitch",
"cyber_noir",
"desert_mirage",
"deep_ocean",
"dark_gold",
"emerald_valley",
"ethereal_ghost",
"forest_shadow",
"golden_era",
"lavender_mist",
"mint_fizz",
"midnight_neon",
"monochrome_pro",
"mangrove_maze",
"paper_heritage",
"riverine_flow",
"retro_synth",
"royal_velvet",
"rustic_clay",
"sakura_bloom",
"solar_flare",
"steel_metropolis",
"sunset_blush",
"volcanic_ash",
"nautical_chart",
"wine_country",
"mediterranean_sun",
"nordic_fjord",
"vintage_atlas",
"rose_gold",
"indigo_night",
"espresso_roast",
"jade_silk",
"twilight_hour",
"sandstone_arch",
"obsidian_glass",
"storm_front",
"tobacco_leather",
"ivory_tower",
"sage_garden",
"coral_depths",
"terracotta_villa",
"dusty_rose",
"midnight_dark",
"minimal_white",
"modern_voyager",
"standard",
"satellite"
],
"type": "string",
"default": "mediterranean_sun",
"description": "Theme key (see list_themes). standard and satellite are classic map tiles for personal use; all others are artistic vector styles."
},
"title": {
"type": "string",
"maxLength": 80,
"description": "Main poster text: the user's own words if they give them, otherwise in their language. Default: the place name. Can be personal, e.g. \"WHERE IT ALL BEGAN\" or two names."
},
"width": {
"type": "integer",
"maximum": 7200,
"minimum": 100,
"description": "Custom canvas width in px (overrides size)."
},
"height": {
"type": "integer",
"maximum": 7200,
"minimum": 100,
"description": "Custom canvas height in px (overrides size)."
},
"text_x": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Horizontal text position, 0-1 (default 0.5)."
},
"text_y": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Vertical text position, 0-1 (default 0.85)."
},
"bearing": {
"type": "number",
"maximum": 360,
"minimum": -180,
"description": "Map rotation in degrees (default 0, north up)."
},
"markers": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 20,
"description": "Pins on the map, e.g. a home or the spot where a couple met."
},
"language": {
"type": "string",
"pattern": "^[a-z]{2}(-[A-Za-z]{2})?$",
"description": "Language for place names, e.g. \"nl\" or \"de\" (default \"en\"). Use the user's language."
},
"subtitle": {
"type": "string",
"maxLength": 80,
"description": "Second line: the user's own words if they give them, otherwise in their language. Default: the country. Can be a date or a short message."
},
"mat_width": {
"type": "integer",
"maximum": 200,
"minimum": 10,
"description": "Mat width in px (default 40)."
},
"text_size": {
"enum": [
"none",
"small",
"medium",
"large"
],
"type": "string",
"description": "Size of the text block (default medium); \"none\" hides all text."
},
"mat_border": {
"type": "boolean",
"description": "Thin line around the map inside the mat (default on)."
},
"show_parks": {
"type": "boolean",
"description": "Artistic themes only."
},
"show_roads": {
"type": "boolean",
"description": "Artistic themes only."
},
"show_water": {
"type": "boolean",
"description": "Artistic themes only."
},
"title_bold": {
"type": "boolean"
},
"title_case": {
"enum": [
"uppercase",
"as_typed",
"capitalize"
],
"type": "string",
"description": "Default uppercase."
},
"title_font": {
"enum": [
"Playfair Display",
"Cormorant Garamond",
"Lora",
"Merriweather",
"Raleway",
"Montserrat",
"Bebas Neue",
"Inter",
"Outfit",
"Open Sans",
"Roboto",
"Dancing Script",
"Caveat",
"Source Code Pro"
],
"type": "string",
"description": "Default Playfair Display."
},
"coordinates": {
"type": "string",
"maxLength": 80,
"description": "Custom text for the coordinates line. Default: the map centre coordinates."
},
"marker_icon": {
"enum": [
"pin",
"circle",
"heart",
"star",
"none"
],
"type": "string",
"description": "Default pin."
},
"marker_size": {
"type": "integer",
"maximum": 120,
"minimum": 10,
"description": "Marker size in px (default 40)."
},
"more_places": {
"type": "array",
"items": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"zoom": {
"type": "number",
"maximum": 18,
"minimum": 1,
"description": "Default: the suggested zoom for the place."
},
"label": {
"type": "string",
"maxLength": 60,
"description": "Text under this map: the user's own words if they give them, otherwise in their language, e.g. \"Where we got engaged\". Default: the place name."
},
"place": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "The place, e.g. \"Paris\" or \"Central Park, New York\". Used when lat/lon are not given (first search match)."
}
}
},
"maxItems": 2,
"minItems": 1,
"description": "Up to two more places on the same poster, each with its own map and a label under it, e.g. where a couple met, got engaged and married. The first map is `place` (or lat/lon); markers and the route stay on it. Artistic themes only; the maps are rectangular (shape is ignored) and the title sits under them (text_x/text_y are ignored)."
},
"place_label": {
"type": "string",
"maxLength": 60,
"description": "With more_places: the label under the first map, in the user's words or language. Default: its place name."
},
"route_color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Route colour as #RRGGBB. Default: the theme route colour."
},
"marker_color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Marker colour as #RRGGBB. Default: the theme accent."
},
"white_border": {
"type": "boolean",
"description": "White frame around the map."
},
"places_layout": {
"enum": [
"auto",
"stacked",
"side_by_side"
],
"type": "string",
"description": "With more_places: the maps stacked or side by side. Default auto: side by side on a landscape or square poster, else stacked."
},
"show_subtitle": {
"type": "boolean"
},
"subtitle_font": {
"enum": [
"Playfair Display",
"Cormorant Garamond",
"Lora",
"Merriweather",
"Raleway",
"Montserrat",
"Bebas Neue",
"Inter",
"Outfit",
"Open Sans",
"Roboto",
"Dancing Script",
"Caveat",
"Source Code Pro"
],
"type": "string",
"description": "Default Playfair Display."
},
"show_buildings": {
"type": "boolean",
"description": "Artistic themes only."
},
"show_map_labels": {
"type": "boolean",
"description": "Street, place and water names on the map, for the themes that offer them (midnight_dark, minimal_white, modern_voyager). Default on."
},
"text_background": {
"enum": [
"none",
"vignette",
"radial"
],
"type": "string",
"description": "Shading behind the text for readability (default none). Not used with a shape: a heart, circle or hexagon keeps its own edge."
},
"title_font_size": {
"type": "integer",
"maximum": 120,
"minimum": 0,
"description": "Title size in px; 0 = automatic (default)."
},
"coordinates_font": {
"enum": [
"Playfair Display",
"Cormorant Garamond",
"Lora",
"Merriweather",
"Raleway",
"Montserrat",
"Bebas Neue",
"Inter",
"Outfit",
"Open Sans",
"Roboto",
"Dancing Script",
"Caveat",
"Source Code Pro"
],
"type": "string",
"description": "Default Outfit."
},
"show_coordinates": {
"type": "boolean"
},
"title_letter_spacing": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Title letter spacing in px (default 0)."
}
}
}