{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/geoapify/json-schema/geoapify-address-autocomplete-xml-response-schema.json",
  "title": "AddressAutocompleteXmlResponse",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/geoapify-address-autocomplete-api-openapi.yml#/components/schemas/AddressAutocompleteXmlResponse",
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/GeocodingProperties"
      }
    },
    "query": {
      "$ref": "#/$defs/TextGeocoderQuery"
    }
  },
  "$defs": {
    "GeocodingProperties": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "continent": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "region": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "state_code": {
          "type": "string"
        },
        "state_COG": {
          "type": "string"
        },
        "department_COG": {
          "type": "string"
        },
        "state_district": {
          "type": "string"
        },
        "province": {
          "type": "string"
        },
        "department": {
          "type": "string"
        },
        "arrondissement": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "county_code": {
          "type": "string"
        },
        "county_district": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "city_district": {
          "type": "string"
        },
        "postcode": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        },
        "openGeoDB:postal_codes": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "suburb": {
          "type": "string"
        },
        "municipality": {
          "type": "string"
        },
        "commune": {
          "type": "string"
        },
        "subdistrict": {
          "type": "string"
        },
        "city_block": {
          "type": "string"
        },
        "neighbourhood": {
          "type": "string"
        },
        "quarter": {
          "type": "string"
        },
        "section": {
          "type": "string"
        },
        "sector": {
          "type": "string"
        },
        "subdivision": {
          "type": "string"
        },
        "croft": {
          "type": "string"
        },
        "allotments": {
          "type": "string"
        },
        "residental": {
          "type": "string"
        },
        "farm": {
          "type": "string"
        },
        "farmyard": {
          "type": "string"
        },
        "industrial": {
          "type": "string"
        },
        "commercial": {
          "type": "string"
        },
        "retail": {
          "type": "string"
        },
        "borough": {
          "type": "string"
        },
        "town": {
          "type": "string"
        },
        "township": {
          "type": "string"
        },
        "village": {
          "type": "string"
        },
        "hamlet": {
          "type": "string"
        },
        "locality": {
          "type": "string"
        },
        "isolated_dwelling": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "road": {
          "type": "string"
        },
        "footway": {
          "type": "string"
        },
        "pedestrian": {
          "type": "string"
        },
        "path": {
          "type": "string"
        },
        "housenumber": {
          "type": "string"
        },
        "house_number": {
          "type": "string"
        },
        "house_name": {
          "type": "string"
        },
        "old_name": {
          "type": "string"
        },
        "other": {
          "type": "string"
        },
        "formatted": {
          "type": "string"
        },
        "address_line1": {
          "type": "string"
        },
        "address_line2": {
          "type": "string"
        },
        "unlocode": {
          "type": "string"
        },
        "iso3166_2": {
          "type": "string"
        },
        "iso3166_2_sublevel": {
          "type": "string"
        },
        "iso3166_sublevel": {
          "type": "string"
        },
        "plus_code": {
          "type": "string"
        },
        "plus_code_short": {
          "type": "string"
        },
        "postcodes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "other_names": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        "population": {
          "type": "number"
        },
        "lon": {
          "type": "number",
          "minimum": -180,
          "maximum": 180
        },
        "lat": {
          "type": "number",
          "minimum": -90,
          "maximum": 90
        },
        "parent_as_place_id": {
          "type": "boolean"
        },
        "timezone": {
          "$ref": "#/$defs/TimezoneOutput"
        },
        "NUTS_3": {
          "type": "string"
        },
        "result_type": {
          "type": "string",
          "enum": [
            "unknown",
            "amenity_name",
            "amenity",
            "building",
            "street",
            "postcode",
            "suburb",
            "district",
            "city",
            "county",
            "state",
            "country"
          ]
        },
        "distance": {
          "type": "number"
        },
        "datasource": {
          "$ref": "#/$defs/PublicDatasource"
        },
        "rank": {
          "$ref": "#/$defs/GeocodingRank"
        },
        "category": {
          "type": "string"
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "place_id": {
          "type": "string",
          "minLength": 3,
          "maxLength": 2048
        },
        "bbox": {
          "type": "object",
          "required": [
            "lon1",
            "lat1",
            "lon2",
            "lat2"
          ],
          "properties": {
            "lon1": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            },
            "lat1": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            },
            "lon2": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            },
            "lat2": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            }
          }
        }
      }
    },
    "GeocodingRank": {
      "type": "object",
      "properties": {
        "confidence": {
          "type": "number"
        },
        "confidence_city_level": {
          "type": "number"
        },
        "confidence_street_level": {
          "type": "number"
        },
        "confidence_building_level": {
          "type": "number"
        },
        "match_type": {
          "type": "string",
          "enum": [
            "full_match",
            "inner_part",
            "match_by_building",
            "match_by_street",
            "match_by_postcode",
            "match_by_city_or_disrict",
            "match_by_country_or_state"
          ]
        },
        "importance": {
          "type": "number"
        },
        "popularity": {
          "type": "number"
        }
      }
    },
    "ParsedAddress": {
      "type": "object",
      "properties": {
        "po_box": {
          "type": "string"
        },
        "unit": {
          "type": "string"
        },
        "house": {
          "type": "string"
        },
        "housenumber": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "suburb": {
          "type": "string"
        },
        "postcode": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "region": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "expected_type": {
          "type": "string",
          "enum": [
            "unknown",
            "amenity_name",
            "amenity",
            "building",
            "street",
            "postcode",
            "suburb",
            "district",
            "city",
            "county",
            "state",
            "country"
          ]
        }
      }
    },
    "PublicDatasource": {
      "type": "object",
      "properties": {
        "sourcename": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "TextGeocoderQuery": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number",
          "minimum": -90,
          "maximum": 90
        },
        "lon": {
          "type": "number",
          "minimum": -180,
          "maximum": 180
        },
        "plus_code": {
          "type": "string"
        },
        "text": {
          "type": "string"
        },
        "postcode": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "housenumber": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "parsed": {
          "$ref": "#/$defs/ParsedAddress"
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "keys",
              "label"
            ],
            "properties": {
              "keys": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "label": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "TimezoneOutput": {
      "type": "object",
      "required": [
        "name",
        "offset_STD",
        "offset_DST",
        "offset_STD_seconds",
        "offset_DST_seconds"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "name_alt": {
          "type": "string"
        },
        "country_codes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "offset_STD": {
          "type": "string"
        },
        "offset_DST": {
          "type": "string"
        },
        "offset_STD_seconds": {
          "type": "number"
        },
        "offset_DST_seconds": {
          "type": "number"
        },
        "abbreviation_STD": {
          "type": "string"
        },
        "abbreviation_DST": {
          "type": "string"
        }
      }
    }
  }
}