Skill: Geo Data PlaceFinder

Objective

Query the geodataplacefinder.org REST API (Overture Maps data) to answer geographic questions: place search, geocoding, reverse geocoding, nearest place lookup, and full place details.

Base URL

https://geodataplacefinder.org

Steps to Follow

1. Detect the language

Always respond in the same language as the user (English or French).

2. Identify the intent and select the right endpoint

3. Retrieve the user's coordinates when needed

If the user says "near me", "nearby", "around me" or similar:

• Use the location available in the user context if provided.
• Otherwise, ask explicitly: "What is your location? (city name or GPS coordinates)"
• If a city name is given, call /api/search?q=<city>&limit=1 first to get its coordinates, then chain to the target endpoint.

Available Endpoints

🔍 /api/search — Place Search (Geocoding)

Use when: the user wants to find a place by name, address, city or category.

Parameters:

Example calls:

curl "https://geodataplacefinder.org/api/search?q=Hilton+Hotel+Paris&limit=5"
curl "https://geodataplacefinder.org/api/search?name=Eiffel+Tower&city=Paris"

JavaScript:

const params = new URLSearchParams({ q: "<query>", limit: 5 });
const res = await fetch(`https://geodataplacefinder.org/api/search?${params}`);
const data = await res.json();

🔄 /api/reverse — Reverse Geocoding

Use when: the user provides GPS coordinates and wants to know what place is there.

Parameters:

Example call:

curl "https://geodataplacefinder.org/api/reverse?lat=48.8584&lon=2.2945"

JavaScript:

const res = await fetch(`https://geodataplacefinder.org/api/reverse?lat=${lat}&lon=${lon}`);
const data = await res.json();

📍 /api/places/nearest — Nearest Place

Use when: the user wants the closest place to a position, optionally filtered by name.

Parameters:

Example call:

curl "https://geodataplacefinder.org/api/places/nearest?lat=48.8584&lon=2.2945&max_distance_m=1000&name=cafe"

JavaScript:

const params = new URLSearchParams({ lat, lon, max_distance_m: 1000 });
const res = await fetch(`https://geodataplacefinder.org/api/places/nearest?${params}`);
const data = await res.json();

🏢 /api/places/:id — Full Place Details

Use when: the user wants all details for a place whose Overture ID is known (obtained from a previous search result).

Parameter:

Example call:

curl "https://geodataplacefinder.org/api/places/overture:place:ac0aed88-e6cb-4224-9520-441339447760"

Notable response fields: names, addresses, location, categories, websites, phones, socials, emails, brand, confidence

❤️ /api/health — API Status

Use when: the user asks if the API is available, or after repeated errors.

curl "https://geodataplacefinder.org/api/health"

Error Handling

Presenting Results

• Always show: place name, address, GPS coordinates (lat/lon)
• If available: category, phone, website, confidence score
• For lists: use a numbered list or table
• GPS coordinates: display with 4 decimal places (e.g. 48.8584, 2.2945)
• Use `places_map_display_v0` to display results on a map when multiple places are returned

Example Questions and Matching Endpoints