git:20260419.352a9b6 to git:20260922.b162b06

7 added, 2 removed. Audit A to A.

---

name: interactive-map

description: >

Shows an interactive Google Maps view for a given location (city, landmark,

- address). Use when the user asks to show, display, or find a place on a map.

+ address) or for the user's own current position. Use when the user asks to

+ show, display, or find a place on a map, or to show where they are.

category: utilities

priority: 50

outputs: [text, frame]

---

# Interactive Map

## Instructions

This skill displays a Google Maps embed directly in the chat so the user can

pan, zoom and interact with the map without leaving the conversation.

When the user asks to show a place on a map:

1. Extract the `location` from the user's query (place name, landmark, address,

or coordinates). Examples: "Paris", "Eiffel Tower", "1 Infinite Loop,

- Cupertino", "48.8584,2.2945".

+ Cupertino", "48.8584,2.2945". When the user asks where THEY are ("where am

+ I", "show me where I am"), the location is the UserLocation coordinates

+ from your context — never a placeholder; if UserLocation is unknown, ask

+ the user to share their position instead of guessing.

2. Call `run_skill_script` with:

- `skill_name`: `interactive-map`

- `script`: `render_map.py`

- `parameters`: `{"location": "<extracted location>"}`

3. Present the returned frame with a concise one-sentence caption (e.g.,

"Voici Paris sur la carte." / "Here is Paris on the map.").

### Output contract

The script returns a `SkillScriptOutput` JSON with:

- `text`: short caption (used for voice/accessibility)

- `frame.url`: Google Maps embed URL (external iframe, HTTPS)

- `frame.title`: header badge

- `frame.aspect_ratio`: 1.333 (4:3, default)

### Examples

- "Show Paris on a map" → `location = "Paris"`

- "Where is the Eiffel Tower?" → `location = "Eiffel Tower"`

- "Display the Louvre on the map" → `location = "Louvre Museum"`

- "Montre-moi la Tour Eiffel sur la carte" → `location = "Tour Eiffel"`

+ - "Show me where I am" → `location = "<UserLocation coordinates>"`

## Ressources disponibles

- `scripts/render_map.py` — Generates the Google Maps embed URL from the location.