DaedalMap Reverse Geocoding (coordinates to loc_id)

{'type': 'object', 'properties': {'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string', 'default': 'lite', 'description': 'Use lite to select a pack, full for expanded metric/query inventories, or download for the complete raw catalog URL.'}, 'loc_id': {'type': 'string', 'description': "Optional DaedalMap loc_id for catalog='data'. Combine with time_range to discover packs confirmed for both place and time. For place details without pack filtering, use get_loc_id_info."}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string', 'default': 'data', 'description': 'Catalog family. The geography facade defaults to geometry; other facades default to data.'}, 'time_range': {'type': 'object', 'properties': {'end': {'anyOf': [{'type': 'string'}, {'type': 'integer'}]}, 'start': {'anyOf': [{'type': 'string'}, {'type': 'integer'}]}}, 'description': "Optional inclusive discovery window for catalog='data'. At least one bound is required.", 'additionalProperties': False}, 'country_scope': {'type': 'string', 'description': "Optional ISO3 focus for catalog='geometry' with detail='lite'."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['catalog', 'detail']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'packs': {'type': 'array', 'items': {'type': 'object'}}, 'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string'}, 'reason': {'type': 'string'}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string'}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'pack_count': {'type': 'integer', 'minimum': 0}, 'provenance': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'download_url': {'type': 'string'}, 'generated_at': {'type': ['string', 'null']}, 'clarification': {'type': 'object'}, 'tool_families': {'type': 'array', 'items': {'type': 'object'}}, 'catalog_version': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['pack_id'], 'properties': {'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string', 'default': 'lite', 'description': 'Use lite to decide and start, full for detailed MCP query metadata, or download for the complete raw metadata file.'}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string', 'description': 'Metadata family. When omitted, geometry facades default to geometry and known geometry-family ids are inferred; all other calls default to data.'}, 'pack_id': {'type': 'string', 'description': 'Pack identifier from get_catalog. Newly catalog-admitted packs require no MCP schema change.'}, 'release_unit': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]+$', 'description': 'Optional non-country geometry release unit such as GLOBAL or MARINE. Do not combine with country_scope.'}, 'country_scope': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Optional ISO3 country for a geometry family. Omit it to learn which countries publish the family; provide it for country-specific versions, vintages, levels, and artifacts.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['catalog', 'pack_id', 'detail']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string'}, 'reason': {'type': 'string'}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string'}, 'pack_id': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'object'}}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'full_call': {'type': 'object'}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'provenance': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'download_url': {'type': 'string'}, 'clarification': {'type': 'object'}, 'download_call': {'type': 'object'}, 'material_policy': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'oneOf': [{'not': {'required': ['topic']}, 'required': ['tool_name']}, {'not': {'required': ['tool_name']}, 'required': ['topic']}], 'properties': {'topic': {'enum': ['overview', 'data', 'disasters', 'custom_data', 'geometry'], 'type': 'string', 'description': 'Workflow overview. Do not combine with tool_name.'}, 'question': {'type': 'string', 'description': 'Optional question used only with a topic overview.'}, 'tool_name': {'type': 'string', 'description': 'Exact tool name from tools/list. Do not combine with topic.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'tool_name']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'title': {'type': ['string', 'null']}, 'access': {'type': 'object'}, 'reason': {'type': 'string'}, 'purpose': {'type': 'string'}, 'examples': {'type': 'array'}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'tool_name': {'type': 'string'}, 'provenance': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'input_schema': {'type': 'object'}, 'clarification': {'type': 'object'}, 'recommended_next_calls': {'type': 'array'}, 'important_output_fields': {'type': 'array'}}, 'additionalProperties': True}

{'type': 'object', 'oneOf': [{'not': {'required': ['points']}, 'required': ['lat', 'lon']}, {'not': {'anyOf': [{'required': ['lat']}, {'required': ['lon']}]}, 'required': ['points']}], 'required': ['shallow_loc_id'], 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in WGS84 decimal degrees.'}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in WGS84 decimal degrees.'}, 'family': {'type': 'string', 'default': 'administrative', 'pattern': '^[a-z0-9_]+$', 'description': 'One family selector. Defaults to administrative; use marine for the direct Marine resolver, or a canonical country family such as postal_area, watershed, or land_management_region.'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['lat', 'lon'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Points already known to fall within the supplied shallow_loc_id scope.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id echoed for point arrays.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'shallow_loc_id': {'type': 'string', 'minLength': 5, 'description': 'The deepest canonical Admin 1-3 loc_id returned by resolve_point, such as USA-NY-061-009903.'}, 'target_admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Optional exact Admin 4-6 level. Omit for the deepest available match.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['point', 'stack']}, {'required': ['point', 'family', 'family_result']}, {'required': ['point_count', 'results']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'point': {'anyOf': [{'type': 'object', 'required': ['lat', 'lon'], 'properties': {'lat': {'type': 'number'}, 'lon': {'type': 'number'}}, 'additionalProperties': True}, {'type': 'null'}]}, 'stack': {'type': 'array', 'items': {'type': 'object'}}, 'family': {'type': 'string'}, 'reason': {'type': 'string'}, 'matched': {'type': ['object', 'null']}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['string', 'integer', 'null']}, 'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'row_index': {'type': ['string', 'integer', 'null']}}, 'additionalProperties': True}}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'join_keys': {'type': 'object'}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'request_id': {'type': ['string', 'null']}, 'point_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'family_result': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'resolved_count': {'type': 'integer', 'minimum': 0}, 'shallow_loc_id': {'type': 'string'}, 'deeper_available': {'type': 'boolean'}, 'overlap_families': {'type': 'array', 'items': {'type': 'object'}}, 'unresolved_count': {'type': 'integer', 'minimum': 0}, 'settlement_receipt': {'type': 'object'}, 'deepest_resolved_family': {'type': ['string', 'null']}, 'deepest_resolved_loc_id': {'type': ['string', 'null']}, 'deepest_resolved_admin_level': {'type': ['string', 'integer', 'null']}, 'available_deeper_admin_levels': {'type': 'array'}}, 'additionalProperties': True}

{'type': 'object', 'oneOf': [{'not': {'required': ['points']}, 'required': ['lat', 'lon']}, {'not': {'anyOf': [{'required': ['lat']}, {'required': ['lon']}]}, 'required': ['points']}], 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in WGS84 decimal degrees.'}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in WGS84 decimal degrees.'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['lat', 'lon'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Bounded WGS84 point array. Use top-level lat/lon instead for one point.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id echoed for point arrays.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'target_admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Optional exact requested level from Admin 0-3. Omit it to return the deepest available shallow level.'}, 'include_marine_context': {'type': 'boolean', 'default': False, 'description': 'Opt in to parallel Marine overlaps for land matches. Defaults to false so ordinary administrative resolution stays lightweight. Offshore Marine fallback still applies.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['point', 'stack']}, {'required': ['point', 'family', 'family_result']}, {'required': ['point_count', 'results']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'point': {'anyOf': [{'type': 'object', 'required': ['lat', 'lon'], 'properties': {'lat': {'type': 'number'}, 'lon': {'type': 'number'}}, 'additionalProperties': True}, {'type': 'null'}]}, 'stack': {'type': 'array', 'items': {'type': 'object'}}, 'family': {'type': 'string'}, 'reason': {'type': 'string'}, 'matched': {'type': ['object', 'null']}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['string', 'integer', 'null']}, 'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'row_index': {'type': ['string', 'integer', 'null']}}, 'additionalProperties': True}}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'join_keys': {'type': 'object'}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'request_id': {'type': ['string', 'null']}, 'point_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'family_result': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'resolved_count': {'type': 'integer', 'minimum': 0}, 'shallow_loc_id': {'type': 'string'}, 'deeper_available': {'type': 'boolean'}, 'overlap_families': {'type': 'array', 'items': {'type': 'object'}}, 'unresolved_count': {'type': 'integer', 'minimum': 0}, 'settlement_receipt': {'type': 'object'}, 'deepest_resolved_family': {'type': ['string', 'null']}, 'deepest_resolved_loc_id': {'type': ['string', 'null']}, 'deepest_resolved_admin_level': {'type': ['string', 'integer', 'null']}, 'available_deeper_admin_levels': {'type': 'array'}}, 'additionalProperties': True}