Create map poster
create_posterDesigns a map poster of a real place and shows a preview of it in the chat. Use this when the user wants a map poster, map print or map wall art of a place, for their home or as a gift (for example, a map of where a couple met). Takes a city, neighborhood, address, landmark or coordinates (up to three places on one poster), a style from list_themes, the poster text, pins, a driving route and a shape; the link it returns opens the design in the MapPoster editor, where it can be adjusted, downloaded as a PNG or, in the drawn map styles, ordered printed. Give a place or lat/lon; the rest is optional. Nothing is saved or bought: the design lives in the link. Not for general gift advice, directions, travel plans, star maps, photo posters, or running, walking or GPX routes.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_poster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude of the map centre. | |
| lon | No | Longitude of the map centre. | |
| mat | No | Gallery-style mat (passe-partout) around the map. | |
| size | No | 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 | No | Zoom: ~11 metro area, 13 city, 15 neighbourhood, 16-17 a few streets. Default: the suggested zoom for the place. | |
| place | No | 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 | No | The driving route between two points, e.g. a road trip, through up to 10 via points. It follows the roads by car: not for running, walking or GPX routes. | |
| shape | No | Map shape (default rectangle); circle, hexagon and heart make the canvas square. | |
| theme | No | Theme key (see list_themes). standard and satellite are classic map tiles for personal use; all others are artistic vector styles. | mediterranean_sun |
| title | No | 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 | No | Custom canvas width in px (overrides size). | |
| height | No | Custom canvas height in px (overrides size). | |
| text_x | No | Horizontal text position, 0-1 (default 0.5). | |
| text_y | No | Vertical text position, 0-1 (default 0.85). | |
| bearing | No | Map rotation in degrees (default 0, north up). | |
| markers | No | Pins on the map, e.g. a home or the spot where a couple met. | |
| language | No | Language for place names, e.g. "nl" or "de" (default "en"). Use the user's language. | |
| subtitle | No | 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 | No | Mat width in px (default 40). | |
| text_size | No | Size of the text block (default medium); "none" hides all text. | |
| mat_border | No | Thin line around the map inside the mat (default on). | |
| show_parks | No | Artistic themes only. | |
| show_roads | No | Artistic themes only. | |
| show_water | No | Artistic themes only. | |
| title_bold | No | ||
| title_case | No | Default uppercase. | |
| title_font | No | Default Playfair Display. | |
| coordinates | No | Custom text for the coordinates line. Default: the map centre coordinates. | |
| marker_icon | No | Default pin. | |
| marker_size | No | Marker size in px (default 40). | |
| more_places | No | 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 | No | With more_places: the label under the first map, in the user's words or language. Default: its place name. | |
| route_color | No | Route colour as #RRGGBB. Default: the theme route colour. | |
| marker_color | No | Marker colour as #RRGGBB. Default: the theme accent. | |
| white_border | No | White frame around the map. | |
| places_layout | No | 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 | No | ||
| subtitle_font | No | Default Playfair Display. | |
| show_buildings | No | Artistic themes only. | |
| show_map_labels | No | Street, place and water names on the map, for the themes that offer them (midnight_dark, minimal_white, modern_voyager). Default on. | |
| text_background | No | 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 | No | Title size in px; 0 = automatic (default). | |
| coordinates_font | No | Default Outfit. | |
| show_coordinates | No | ||
| title_letter_spacing | No | Title letter spacing in px (default 0). |