cs_search_for_geonames_id
Find GeoNames IDs for place names to filter correspondences by location. Resolves place names to standard identifiers for correspSearch queries.
Instructions
Search for GeoNames IDs by place name.
PURPOSE: Find GeoNames identifiers for places to use as filters.
WHEN TO USE:
When you need a GeoNames ID for correspSearch place filtering
To resolve place names to standard identifiers
For geographic analysis of correspondence networks
WHEN NOT TO USE:
For person or organization names → use search_for_gnd_id()
When you already have a GeoNames ID
Args: place_query: Place name to search for (e.g., "Berlin", "Paris") country: Optional ISO-2 country code to restrict search (e.g., "DE", "FR") limit: Maximum number of results to return
Returns: List of dicts with place information: - geonameId: The GeoNames ID (use this for correspSearch) - name: Place name - countryCode: ISO-2 country code - lat, lng: Coordinates - adminName1: First-level admin division (e.g., state) - population: Population count (if available)
Example: >>> results = await search_for_geonames_id("Berlin", country="DE") >>> geonames_id = str(results[0]['geonameId']) >>> letters = await search_correspondences(place_geonames=geonames_id)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| country | No | ||
| place_query | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |