Show Geo Map

Show_Geo_Map renders an interactive geo workspace inside chat. Use it for named marker series, route overlays, dense point maps with clustering, and marker-selection workflows where the user should click locations instead of replying in free text.

When To Use

  • Use Show_Geo_Map for geographic review of buyer offices, vendor offices, field sites, target facilities, or other point-based location sets.

  • Use Show_Geo_Map when a route overlay helps explain travel, coverage, or HQ-to-site relationships.

  • Turn on selection when the user should click markers and send the chosen locations back to chat through Interaction_State.

  • Turn on clustering for dense office, site, or facility maps where point overlap would otherwise make the map unreadable.

  • Do not use Show_Geo_Map for choropleths, boundary-layer analysis, GeoJSON polygons, or heatmaps in this phase.

  • Use Show_Chart when the user needs a trend, comparison, or leaderboard rather than a geographic surface.

Contract

  • Required top-level keys:

    • id

    • series

  • Optional top-level keys:

    • title

    • description

    • clustering

    • viewport

    • selection

    • legend

    • routes

Series And Markers

  • series is a required non-empty array.

  • Each series must include:

    • id

    • label

    • markers

  • Each marker must include:

    • id

    • lat

    • lng

    • label

  • Optional marker keys:

    • subLabel

    • tooltip

    • detail

    • recordRef

    • metadata

    • style

  • Optional series keys:

    • color

    • style

  • Marker ids must be unique across the entire map so selection state can address them safely.

clustering

  • clustering is an optional strict object for dense marker sets.

  • Supported shape:

  • Clustering applies only to markers, never routes.

  • Cluster clicks zoom or spiderfy; clusters are not themselves selectable.

viewport

  • viewport is an optional strict object.

  • Supported shape:

  • mode values:

    • fit_all

    • center_zoom

  • center_zoom requires both center and zoom.

  • fit_all auto-fits all markers and routes and does not accept center or zoom.

selection

  • selection is an optional strict object.

  • Selection is marker-only in this phase.

  • When selection.enabled is true, Show_Geo_Map returns interaction fields and writes canonical marker selections, selected record refs, viewport state, and last-event metadata through Interaction_State.

  • Supported shape:

  • mode values:

    • single

    • multi

  • tools values:

    • click

    • box

  • click is always required.

  • box enables Shift-drag box selection on multi-select maps.

  • allowSelectInView shows a “Select visible” action that replaces the current selection with markers inside the current viewport.

Marker Styling

  • Use series.style for semantic defaults and marker.style only for per-marker emphasis.

  • Supported style shape:

  • Supported size values:

    • sm

    • md

    • lg

  • Supported icon values:

    • circle

    • square

    • diamond

    • triangle

    • star

routes

  • routes is an optional array.

  • Each route must include:

    • id

    • points

  • Optional route keys:

    • label

    • tooltip

    • detail

    • style

  • style is a strict object like:

Canonical Examples

Static multi-series office map:

Selectable buyer-office map with box select and select-visible:

Clustered styled office map:

Route / coverage map:

Last updated

Was this helpful?