MapPoster

Use this when a map poster needs a place's coordinates, such as the street or venue to mark (where a couple met, a new home), or when the place the user named is ambiguous (several towns share the name) and they should pick one. Finds a city, neighborhood, street address, venue, landmark or coordinates and gives its coordinates and a suggested zoom level; use the result with create_poster. Not for directions, travel times, general map questions or the user's current location.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "What to look for, e.g. \"Utrecht\", \"Central Park, New York\", \"Eiffel Tower\" or \"52.0907, 5.1214\"."
    },
    "limit": {
      "default": 5,
      "description": "Maximum number of results.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "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."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user wants to see or choose a map poster's style: its colors, a mood (minimalist, black and white, vintage, blueprint, dark, pastel, or pink for a wedding or anniversary) or a theme by name. Lists the MapPoster themes (color styles) with their key colors, whether the PNG download covers them, and which ones are for personal use only. Pass the theme key to create_poster.

{
  "type": "object",
  "properties": {
    "render_mode": {
      "default": "all",
      "description": "artistic = vector styles (all but two, including the classic city maps); tile = OpenStreetMap and satellite map tiles.",
      "type": "string",
      "enum": [
        "all",
        "artistic",
        "tile"
      ]
    },
    "search": {
      "description": "One word matched literally against theme names and descriptions, e.g. \"dark\", \"vintage\", \"pink\", \"neon\" or \"blueprint\". For a mood such as black and white, minimalist or pastel, leave it out and choose from the full list.",
      "type": "string",
      "maxLength": 40
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Designs a map poster and shows it in the chat. Use this when the user wants a map poster, map print, map wall art or map wallpaper of a real place, or a map poster as an anniversary, Valentine's, wedding, engagement or housewarming gift tied to a place: where a couple met or married, a first home, a hometown, a city someone is leaving, a trip, a marathon someone ran or a birthplace. Not for general gift advice, directions, travel plans, star or night-sky maps, photo posters, 3D, wooden, scratch-off or push-pin maps, or hiking trails and GPX tracks. Takes a city, neighborhood, address, landmark or coordinates (up to three places) and links to the MapPoster editor to fine-tune it or, in the drawn map styles, order it printed. Give a `place` or `lat`/`lon`; the rest is optional. Nothing is saved or bought: the design lives in the link.

{
  "type": "object",
  "properties": {
    "place": {
      "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).",
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "lat": {
      "description": "Latitude of the map centre.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude of the map centre.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "zoom": {
      "description": "Zoom: ~11 metro area, 13 city, 15 neighbourhood, 16-17 a few streets. Default: the suggested zoom for the place.",
      "type": "number",
      "minimum": 1,
      "maximum": 20
    },
    "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."
    },
    "theme": {
      "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.",
      "type": "string",
      "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"
      ]
    },
    "title": {
      "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.",
      "type": "string",
      "maxLength": 80
    },
    "subtitle": {
      "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.",
      "type": "string",
      "maxLength": 80
    },
    "coordinates": {
      "description": "Custom text for the coordinates line. Default: the map centre coordinates.",
      "type": "string",
      "maxLength": 80
    },
    "show_subtitle": {
      "type": "boolean"
    },
    "show_coordinates": {
      "type": "boolean"
    },
    "text_size": {
      "description": "Size of the text block (default medium); \"none\" hides all text.",
      "type": "string",
      "enum": [
        "none",
        "small",
        "medium",
        "large"
      ]
    },
    "text_background": {
      "description": "Shading behind the text for readability (default none). Not used with a shape: a heart, circle or hexagon keeps its own edge.",
      "type": "string",
      "enum": [
        "none",
        "vignette",
        "radial"
      ]
    },
    "text_x": {
      "description": "Horizontal text position, 0-1 (default 0.5).",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "text_y": {
      "description": "Vertical text position, 0-1 (default 0.85).",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "title_font": {
      "description": "Default Playfair Display.",
      "type": "string",
      "enum": [
        "Playfair Display",
        "Cormorant Garamond",
        "Lora",
        "Merriweather",
        "Raleway",
        "Montserrat",
        "Bebas Neue",
        "Inter",
        "Outfit",
        "Open Sans",
        "Roboto",
        "Dancing Script",
        "Caveat",
        "Source Code Pro"
      ]
    },
    "subtitle_font": {
      "description": "Default Playfair Display.",
      "type": "string",
      "enum": [
        "Playfair Display",
        "Cormorant Garamond",
        "Lora",
        "Merriweather",
        "Raleway",
        "Montserrat",
        "Bebas Neue",
        "Inter",
        "Outfit",
        "Open Sans",
        "Roboto",
        "Dancing Script",
        "Caveat",
        "Source Code Pro"
      ]
    },
    "coordinates_font": {
      "description": "Default Outfit.",
      "type": "string",
      "enum": [
        "Playfair Display",
        "Cormorant Garamond",
        "Lora",
        "Merriweather",
        "Raleway",
        "Montserrat",
        "Bebas Neue",
        "Inter",
        "Outfit",
        "Open Sans",
        "Roboto",
        "Dancing Script",
        "Caveat",
        "Source Code Pro"
      ]
    },
    "title_font_size": {
      "description": "Title size in px; 0 = automatic (default).",
      "type": "integer",
      "minimum": 0,
      "maximum": 120
    },
    "title_letter_spacing": {
      "description": "Title letter spacing in px (default 0).",
      "type": "number",
      "minimum": 0,
      "maximum": 20
    },
    "title_bold": {
      "type": "boolean"
    },
    "title_case": {
      "description": "Default uppercase.",
      "type": "string",
      "enum": [
        "uppercase",
        "as_typed",
        "capitalize"
      ]
    },
    "size": {
      "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.",
      "type": "string",
      "enum": [
        "poster_portrait",
        "poster_landscape",
        "square",
        "instagram_portrait",
        "story",
        "pinterest",
        "desktop_wallpaper",
        "a4",
        "a3",
        "a2",
        "18x24in"
      ]
    },
    "width": {
      "description": "Custom canvas width in px (overrides size).",
      "type": "integer",
      "minimum": 100,
      "maximum": 7200
    },
    "height": {
      "description": "Custom canvas height in px (overrides size).",
      "type": "integer",
      "minimum": 100,
      "maximum": 7200
    },
    "shape": {
      "description": "Map shape (default rectangle); circle, hexagon and heart make the canvas square.",
      "type": "string",
      "enum": [
        "rectangle",
        "circle",
        "hexagon",
        "heart"
      ]
    },
    "bearing": {
      "description": "Map rotation in degrees (default 0, north up).",
      "type": "number",
      "minimum": -180,
      "maximum": 360
    },
    "show_water": {
      "description": "Artistic themes only.",
      "type": "boolean"
    },
    "show_parks": {
      "description": "Artistic themes only.",
      "type": "boolean"
    },
    "show_roads": {
      "description": "Artistic themes only.",
      "type": "boolean"
    },
    "show_buildings": {
      "description": "Artistic themes only.",
      "type": "boolean"
    },
    "show_map_labels": {
      "description": "Street, place and water names on the map, for the themes that offer them (midnight_dark, minimal_white, modern_voyager). Default on.",
      "type": "boolean"
    },
    "mat": {
      "description": "Gallery-style mat (passe-partout) around the map.",
      "type": "boolean"
    },
    "mat_width": {
      "description": "Mat width in px (default 40).",
      "type": "integer",
      "minimum": 10,
      "maximum": 200
    },
    "mat_border": {
      "description": "Thin line around the map inside the mat (default on).",
      "type": "boolean"
    },
    "white_border": {
      "description": "White frame around the map.",
      "type": "boolean"
    },
    "markers": {
      "description": "Pins on the map, e.g. a home or the spot where a couple met.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180
          }
        },
        "required": [
          "lat",
          "lon"
        ]
      }
    },
    "marker_icon": {
      "description": "Default pin.",
      "type": "string",
      "enum": [
        "pin",
        "circle",
        "heart",
        "star",
        "none"
      ]
    },
    "marker_color": {
      "description": "Marker colour as #RRGGBB. Default: the theme accent.",
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$"
    },
    "marker_size": {
      "description": "Marker size in px (default 40).",
      "type": "integer",
      "minimum": 10,
      "maximum": 120
    },
    "route": {
      "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.",
      "type": "object",
      "properties": {
        "start": {
          "type": "object",
          "properties": {
            "lat": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            },
            "lon": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          "required": [
            "lat",
            "lon"
          ]
        },
        "end": {
          "type": "object",
          "properties": {
            "lat": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            },
            "lon": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          "required": [
            "lat",
            "lon"
          ]
        },
        "via": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              }
            },
            "required": [
              "lat",
              "lon"
            ]
          }
        }
      },
      "required": [
        "start",
        "end"
      ]
    },
    "route_color": {
      "description": "Route colour as #RRGGBB. Default: the theme route colour.",
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$"
    },
    "more_places": {
      "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).",
      "minItems": 1,
      "maxItems": 2,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "place": {
            "description": "The place, e.g. \"Paris\" or \"Central Park, New York\". Used when lat/lon are not given (first search match).",
            "type": "string",
            "minLength": 2,
            "maxLength": 200
          },
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180
          },
          "zoom": {
            "description": "Default: the suggested zoom for the place.",
            "type": "number",
            "minimum": 1,
            "maximum": 18
          },
          "label": {
            "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.",
            "type": "string",
            "maxLength": 60
          }
        }
      }
    },
    "place_label": {
      "description": "With more_places: the label under the first map, in the user's words or language. Default: its place name.",
      "type": "string",
      "maxLength": 60
    },
    "places_layout": {
      "description": "With more_places: the maps stacked or side by side. Default auto: side by side on a landscape or square poster, else stacked.",
      "type": "string",
      "enum": [
        "auto",
        "stacked",
        "side_by_side"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}