docugis_map
Generate a TSV of named place coordinates for DocuGIS2 import, enabling map visualization with optional dates and popup text; no geocoding, only formats coordinates you provide.
Instructions
Put places on a map in DocuSky's own DocuGIS2 tool.
Takes coordinates you already have — from the user, from a placeInfo in
search_documents, from a gazetteer, or from your own knowledge of where a
place is — and returns the TSV that DocuGIS2's import box accepts. This
tool does no geocoding and no searching: never invent coordinates for a
place you are unsure of; leave that row out, or ask the user.
DocuGIS2 cannot be fed data through a URL, so the last step belongs to the
user: MCP Apps-capable hosts show the TSV with a copy button next to the
embedded tool, and the user pastes it into DocuGIS2's box and presses 匯入
(the rendered map then does time filtering, routes, clustering, heatmaps
and export). Other hosts get the same TSV as text plus webUrl, to paste
into DocuGIS2 in a browser. Tell the user that paste step is theirs.
Args:
rows: One entry per place. name plus x (WGS84 longitude) and y
(latitude) are required; date, text and any other keys are
optional and become extra columns in DocuGIS2's popups. Common
aliases are understood (lng/lon/經度 -> x, lat/緯度 -> y,
地名 -> name). Example: [{"name": "鹿港", "x": 120.434,
"y": 24.057, "date": "1784-01-01", "text": "鹿港開港"}].
title: A name for this map, shown above the tool.
include_dates: Leave unset to decide automatically. DocuGIS2 drops any
row whose date cell is empty or a bare year, so a half-dated set
ships without the date column (every place on the map, no time
axis). Pass true to keep the timeline and lose the undated rows,
false to drop dates entirely.
max_rows: Keep at most this many places (default 2000).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | Yes | ||
| title | No | ||
| max_rows | No | ||
| include_dates | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |