DaedalMap Geography Tools (loc_id)

{'type': 'object', 'anyOf': [{'required': ['left_loc_id', 'right_loc_id']}, {'required': ['items']}], 'properties': {'as_of': {'type': 'string', 'description': 'ISO date or year applied to both identities.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['left_loc_id', 'right_loc_id'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'as_of': {'type': 'string'}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'left_as_of': {'type': 'string'}, 'left_loc_id': {'type': 'string'}, 'right_as_of': {'type': 'string'}, 'right_loc_id': {'type': 'string'}, 'include_successors': {'type': 'boolean'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Bounded geography pairs to compare in one call.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'left_as_of': {'type': 'string', 'description': 'Optional ISO date or year for the left identity; overrides as_of.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'left_loc_id': {'type': 'string', 'description': 'First DaedalMap loc_id.'}, 'right_as_of': {'type': 'string', 'description': 'Optional ISO date or year for the right identity; overrides as_of.'}, 'right_loc_id': {'type': 'string', 'description': 'Second DaedalMap loc_id.'}, 'include_successors': {'type': 'boolean', 'description': 'Include direct successors and present-day descendants for maintained historical identities. Default true.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'spatial_relation']}, {'required': ['item_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}, 'reason': {'type': 'string'}, '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'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'item_count': {'type': 'integer', 'minimum': 0}, 'request_id': {'type': ['string', 'null']}, 'failed_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'compared_count': {'type': 'integer', 'minimum': 0}, 'spatial_relation': {'type': ['string', 'object', 'null']}, 'temporal_relation': {'type': ['string', 'object', 'null']}, 'settlement_receipt': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['from_system', 'value']}, {'required': ['items']}], 'properties': {'iso3': {'type': 'string', 'description': 'Country hint for crosswalk artifacts. Default USA.'}, 'as_of': {'type': 'string', 'description': 'ISO date or year used for time-bounded identities.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['value'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}], 'description': 'Optional caller identifier echoed in the result.'}, 'iso3': {'type': 'string', 'description': 'Optional country hint for this row.'}, 'as_of': {'type': 'string', 'description': 'ISO date or year used for time-bounded identities.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum ranked output references for this row.'}, 'value': {'type': 'string', 'description': 'Identifier or name in the input system.'}, 'min_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional minimum overlap share threshold for this row.'}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}], 'description': 'Optional caller row identifier echoed in the result.'}, 'to_system': {'type': 'string', 'description': 'Output reference system for this row. Defaults to top-level to_system when omitted.'}, 'from_system': {'type': 'string', 'description': 'Input reference system for this row. Defaults to top-level from_system when omitted.'}, 'country_hint': {'type': 'string', 'description': 'Optional country hint for admin/name resolution.'}, 'admin_level_hint': {'type': 'integer', 'maximum': 6, 'minimum': 0, 'description': 'Optional admin-level hint for admin/name resolution.'}, 'target_admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Optional intermediate admin target level for this row.'}, 'relationship_vintage': {'type': 'string', 'description': 'Optional relationship vintage for this row.'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Reference conversions to run in one call. Default public cap is deployment-configurable.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum ranked output references to return. Default 10.'}, 'value': {'type': 'string', 'description': 'Identifier or name in the input system.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'min_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional minimum overlap share threshold.'}, 'to_system': {'type': 'string', 'default': 'daedalmap.loc_id', 'description': 'Optional output reference system. Defaults to DaedalMap loc_id; provide zcta, nws_fire, overlay_nws_public_zone, overlay_tribal, admin_local, or another catalog system for any-to-any conversion.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'from_system': {'type': 'string', 'description': 'Input reference system, such as zip, overlay_zcta, nws_fire, tribal, admin_boundary, or loc_id.'}, 'country_hint': {'type': 'string', 'description': 'Optional country hint for admin/name resolution.'}, 'admin_level_hint': {'type': 'integer', 'maximum': 6, 'minimum': 0, 'description': 'Optional admin-level hint for admin/name resolution.'}, 'target_admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Admin level used as the intermediate crosswalk target. Default admin_2.'}, 'relationship_vintage': {'type': 'string', 'description': 'Optional source relationship vintage to require.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'results']}, {'required': ['item_count', 'results']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'from': {'type': 'object'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'loc_id': {'type': ['string', 'null']}, 'reason': {'type': 'string'}, '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'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'to_system': {'type': 'string'}, 'item_count': {'type': 'integer', 'minimum': 0}, 'request_id': {'type': ['string', 'null']}, 'from_system': {'type': 'string'}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'converted_count': {'type': 'integer', 'minimum': 0}, 'unconverted_count': {'type': 'integer', 'minimum': 0}, 'settlement_receipt': {'type': 'object'}}, 'additionalProperties': True}

{'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', 'oneOf': [{'required': ['loc_id']}, {'required': ['loc_ids']}, {'required': ['scope']}], 'properties': {'scope': {'type': 'object', 'required': ['parent_loc_id', 'admin_level'], 'properties': {'bbox': {'anyOf': [{'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4}, {'type': 'string'}], 'description': 'Optional minLon,minLat,maxLon,maxLat intersection filter.'}, 'admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Descendant level to retrieve, such as admin_2, 2, or county.'}, 'parent_loc_id': {'type': 'string', 'description': 'Administrative parent loc_id, such as USA-TX or CAN-BC.'}}, 'additionalProperties': False}, 'loc_id': {'type': 'string', 'description': 'DaedalMap loc_id, such as USA-CA-037, USA-Z-00601, USA-NWSFZ-AKZ317, EEZ-USA, or IHO1953-240001002.'}, 'loc_ids': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Exact DaedalMap loc_ids to fetch in one call. Default public cap is deployment-configurable and lower when include_polygon is true.', 'uniqueItems': True}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'include_polygon': {'type': 'boolean', 'description': 'When true, include the full GeoJSON geometry. Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'selection', 'items']}, {'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}, 'items': {'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}}, 'scope': {'type': ['object', 'null']}, 'reason': {'type': 'string'}, 'missing': {'type': 'integer', 'minimum': 0}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'available': {'type': 'integer', 'minimum': 0}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'requested': {'type': 'integer', 'minimum': 0}, 'selection': {'enum': ['exact_loc_ids', 'admin_scope'], 'type': 'string'}, 'request_id': {'type': ['string', 'null']}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'include_polygon': {'type': 'boolean'}, 'settlement_receipt': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['loc_id']}, {'required': ['loc_ids']}], 'properties': {'iso3': {'type': 'string', 'description': 'Optional country hint for crosswalk artifacts. Defaults to the loc_id country when possible.'}, 'loc_id': {'type': 'string', 'description': "DaedalMap loc_id, e.g. 'USA-CA'."}, 'loc_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'DaedalMap loc_ids to inspect together, including every loc_id from a resolve_point stack. Default public cap is deployment-configurable.'}, 'systems': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional reference systems to include when include_references is true, such as zcta, nws_fire, overlay_tribal, or overlay_nws_public_zone.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'min_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional minimum target-area share for reverse overlap references.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'limit_per_system': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum overlap references to return per bridge/system. Default 10.'}, 'include_hierarchy': {'type': 'boolean', 'description': 'When true, include strict stored parent and ancestor data. This never invents a parent edge across mixed releases. Default false.'}, 'include_references': {'type': 'boolean', 'description': 'When true, include known external or side-chain references attached to each loc_id. Default false.'}, 'target_admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Admin level for crosswalk-backed reverse reference lookup. Inferred when omitted.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['loc_id']}, {'required': ['loc_id_count', 'results']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'iso3': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'family': {'type': ['string', 'null']}, 'loc_id': {'type': 'string'}, 'reason': {'type': 'string'}, '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'}}, 'hierarchy': {'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}, 'data_packs': {'type': 'array'}, 'next_calls': {'type': 'array'}, 'references': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'admin_level': {'type': ['string', 'integer', 'null']}, 'found_count': {'type': 'integer', 'minimum': 0}, 'loc_id_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'missing_count': {'type': 'integer', 'minimum': 0}, 'requested_loc_id': {'type': 'string'}, 'geometry_families': {'type': 'array'}, 'settlement_receipt': {'type': 'object'}}, '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', 'required': ['columns'], 'properties': {'columns': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'values'], 'properties': {'name': {'type': 'string'}, 'values': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 32}, 'nonempty_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 64, 'minItems': 1, 'description': 'Structurally filtered columns with deterministic representative scalar values. Do not pre-label their geographic system.'}, 'request_id': {'type': 'string'}, 'country_scope': {'type': 'string', 'description': 'Optional caller-declared ISO3 hint. Omit when unknown.'}, 'dataset_context': {'type': 'object', 'properties': {'file_name': {'type': 'string'}, 'row_count': {'type': 'integer', 'minimum': 0}, 'sheet_name': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'status', 'candidates']}, {'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}, 'limit': {'type': 'integer', 'minimum': 0}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'batch_id': {'type': ['string', 'null']}, '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}, 'candidates': {'type': 'array', 'items': {'type': 'object'}}, 'request_id': {'type': ['string', 'null']}, 'column_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'review_required': {'type': 'boolean'}, 'identifier_count': {'type': 'integer', 'minimum': 0}, 'coordinate_binding': {'type': ['object', 'null']}, 'settlement_receipt': {'type': 'object'}, 'recommended_binding': {'type': ['object', 'null']}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['identifier']}, {'required': ['identifiers']}], 'properties': {'expected': {'type': 'object', 'properties': {'system': {'type': 'string', 'description': 'Caller-declared reference system, such as us_census_geoid, loc_id, zcta, or a catalog reference system. Supply it immediately when known, or after choosing an identification result.'}, 'vintage': {'type': 'string', 'description': 'Expected source/reference vintage, such as 2020.'}, 'geo_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Expected geography level, such as tract or admin_3.'}, 'country_scope': {'type': 'string', 'description': 'Expected ISO3 country scope.'}}, 'additionalProperties': False}, 'identifier': {'type': 'string', 'description': 'One geography identifier to inspect.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'identifiers': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'A bounded representative identifier sample. Duplicate values are checked once. Values must be strings so leading zeros are preserved.'}, 'country_scope': {'type': 'string', 'description': 'Optional ISO3 country hint used to narrow candidate banks.'}, 'dataset_context': {'type': 'object', 'properties': {'file_name': {'type': 'string'}, 'sheet_name': {'type': 'string'}, 'column_name': {'type': 'string'}, 'column_names': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 1000}, 'row_geography': {'type': 'string', 'description': 'Optional plain-language clue such as county, tract, or ZIP area.'}, 'local_format_match_rate': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'description': 'Bounded, non-row dataset clues used to rank plausible interpretations without replacing exact identifier verification.', 'additionalProperties': False}, 'validation_scope': {'enum': ['sample', 'all_distinct_identifiers'], 'type': 'string', 'description': 'Describes whether the bounded input is a sample or, only when it fits the identification cap, the complete distinct-key set. This tool validates every supplied identifier; create_conversion_job validates every row in the full dataset.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'status', 'candidates']}, {'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}, 'limit': {'type': 'integer', 'minimum': 0}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'batch_id': {'type': ['string', 'null']}, '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}, 'candidates': {'type': 'array', 'items': {'type': 'object'}}, 'request_id': {'type': ['string', 'null']}, 'column_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'review_required': {'type': 'boolean'}, 'identifier_count': {'type': 'integer', 'minimum': 0}, 'coordinate_binding': {'type': ['object', 'null']}, 'settlement_receipt': {'type': 'object'}, 'recommended_binding': {'type': ['object', 'null']}}, '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}