Find By Icbm
find_by_icbmRead-only
WHAT: Rank Einsatzgebiete by an ICBM 'lat, lng' string (optional lat/lng, radius_km, limit). RETURNS items with distance_km. USE when the user pastes ICBM metadata. Prefer find_by_geo instead for plain lat/lng without an ICBM string. (0,0) and far points → ok=false outside_service_area. DOES NOT route or drive-time. NEXT: get_service_area, get_embed_map, get_grenze.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | WGS84 latitude. Required with lng unless icbm is set. (0,0) → outside_service_area. | |
| lng | No | WGS84 longitude. Required with lat unless icbm is set. | |
| icbm | No | ICBM or paste 'lat, lng' (comma-separated). Alternative to lat+lng. | |
| limit | No | Maximum items or lines to return after offset. Omit = all remaining in the window (subject to tool-specific clamps). For geo near-search default is often 5 without radius_km, up to 52 with radius. | |
| radius_km | No | Optional air-radius filter in km. Omit = return nearest N (limit). Far points / (0,0) → outside_service_area. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | true = use summary, canonicalUrl, and extra keys. false = do not invent data; read error + hint and retry with valid args or open hint. | |
| lat | No | ||
| lng | No | ||
| hint | No | Present when ok=false. Absolute URL or short recovery hint the agent should open or pass to another tool. | |
| icbm | No | ||
| tool | Yes | Echo of the tool name that produced this object (e.g. get_service_area). | |
| count | No | ||
| error | No | Present when ok=false. Codes include: unknown_place, unknown_discovery, unknown_doc, q_required, plz_required, coords_required, outside_service_area, url_required, not_maps_host, bad_url, path_or_url_required, serp_not_found, slug_or_coords_required, path_required. | |
| items | No | ||
| locale | No | Locale actually used for URLs. maps is German-only: always de (MAPS-E8 — no /en on maps). Requested non-de is ignored; payload locale=de. | |
| related | No | Always includes https://maps.ikeytz.com/llms.txt. | |
| summary | No | Primary text for the model. For discovery tools this is the file window. For list tools a compact one-liner. Quote with attribution. | |
| radius_km | No | ||
| nearest_km | No | ||
| attribution | Yes | Required citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://maps.ikeytz.com/.well-known/ai.txt' | |
| canonicalUrl | No | Best URL to show the user: https://maps.ikeytz.com… page, public embed JSON, tel:+49…, mailto:…, https://wa.me/…, or a www pointer. Prefer this over constructing URLs. |