Address search with accuracy to the house by FIAS ID of the locality #

Method address #

POST /idsearch/address/center

Functionality #

Address search with accuracy to the house by fias locality Allows you to get the exact address with accuracy to the house by FIAS ID of the locality.

Request parameters #

Parameter	Description	Type	Example
query	FIAS ID of the locality	string	93adb246-540e-40a2-a0fd-e96ca6796589
countryCode	Country code, using ISO 3166-1 alpha-2 string	string	RU

Sample request data #

{
  "query": "93adb246-540e-40a2-a0fd-e96ca6796589",
  "countryCode": "RU"
}

Response options #

Parameter	Description
original	An incoming address string that participated in the standardization
address	Parsed and standardized address string
addressFull	Parsed and standardized address string with house part
postcodeIn	ZIP code found in the input string
postcode	Postal code determined from the reference base in the process of standardization
region	Region, region. See the description of the addressLevel structure
area	District of the region. See the description of the addressLevel structure
municipal	Municipal entity. See the description of the addressLevel structure
city	Town. See the description of the addressLevel structure
cityArea	A district of the city. See the description of the addressLevel structure
settlement	Locality. See the description of the addressLevel structure
planStructure	Planning structure (microdistrict). See the description of the addressLevel structure
street	Street. See the description of the addressLevel structure
houseDetails	House part of the address. See the description of the structure houseDetails
coordinates	Geographical coordinates. See the description of the structure coordinates
country	Country. See the description of the country structure
valid	Sign of correctness of the address
quality	Address quality code. See Address Quality Code
timezone	Time zone

Descriptions of structures are available on the address standardization page.

Sample response data #

{
    "original": "93adb246-540e-40a2-a0fd-e96ca6796589",
    "addressFull": "Архангельская обл, Котласский р-н, г Котлас, ул К.Маркса, дом 7",
    "address": "Архангельская обл, Котласский р-н, г Котлас, ул К.Маркса",
    "postcodeIn": "",
    "postcode": "165300",
    "region": {
        "fullName": "Архангельская обл",
        "name": "Архангельская",
        "type": "обл",
        "codes": {
            "fias": "294277aa-e25d-428c-95ad-46719c4ddb44",
            "ga": "RU0290000000000000000000000",
            "osm": "",
            "gar": "442495",
            "kladr": "2900000000000"
        }
    },
    "area": {
        "fullName": "Котласский р-н",
        "name": "Котласский",
        "type": "р-н",
        "codes": {
            "fias": "cfa3b599-159c-49f9-992e-3aa64c675ad6",
            "ga": "RU0290080000000000000000000",
            "osm": "",
            "gar": "447206",
            "kladr": "2900800000000"
        }
    },
    "municipal": null,
    "city": {
        "fullName": "г Котлас",
        "name": "Котлас",
        "type": "г",
        "codes": {
            "fias": "93adb246-540e-40a2-a0fd-e96ca6796589",
            "ga": "RU0290080001000000000000000",
            "osm": "",
            "gar": "447238",
            "kladr": "2900800100000"
        }
    },
    "cityArea": {
        "fullName": "",
        "name": "",
        "type": "",
        "codes": {
            "fias": "",
            "ga": "",
            "osm": "",
            "gar": "",
            "kladr": ""
        }
    },
    "settlement": {
        "fullName": "",
        "name": "",
        "type": "",
        "codes": {
            "fias": "",
            "ga": "",
            "osm": "",
            "gar": "",
            "kladr": ""
        }
    },
    "planStructure": {
        "fullName": "",
        "name": "",
        "type": "",
        "codes": {
            "fias": "",
            "ga": "",
            "osm": "",
            "gar": "",
            "kladr": ""
        }
    },
    "street": {
        "fullName": "ул К.Маркса",
        "name": "К.Маркса",
        "type": "ул",
        "codes": {
            "fias": "f2f4563a-d616-49c7-86e7-dfcd1b9568d8",
            "ga": "RU0290080001000000000000017",
            "osm": "",
            "gar": "449386",
            "kladr": "29008001000001700"
        }
    },
    "houseDetails": {
        "fullName": "дом 7",
        "house": "7",
        "case": "",
        "build": "",
        "liter": "",
        "lend": "",
        "constr": "",
        "stead": "",
        "flat": "",
        "office": "",
        "room": "",
        "kab": "",
        "place": "",
        "entr": "",
        "floor": "",
        "block": "",
        "pav": "",
        "sek": "",
        "abon": "",
        "munit": "",
        "codes": {
            "fias": "e0b7f122-9723-427f-a673-7b2acfe67455",
            "ga": "",
            "osm": "",
            "gar": "74228981",
            "kladr": ""
        }
    },
    "coordinates": {
        "latitude": 61.253212,
        "longitude": 46.633204
    },
    "country": {
        "name": "Россия",
        "alpha2": "RU",
        "alpha3": "RUS",
        "numeric": 643
    },
    "valid": true,
    "quality": {
        "unique": 0,
        "actuality": 0,
        "undefined": 0,
        "level": 8,
        "house": 3,
        "geo": 8
    },
    "timezone": "UTC+3"
}