Additional information about objects
Using the fields parameter, you can obtain additional information about objects in the response: object address, geometry, contact information, and other data.
Obtaining certain fields is available on demand and for an extra cost. For the list of such fields, see the Additional information on demand section.
The fields parameter can be specified for all current Places API endpoints. Below are request examples for obtaining information about objects using the fields parameter. For the full list of fields, see the API Reference.
Obtaining building information
To obtain information about a building, send a GET request to /3.0/items/byid with the following parameters:
-
id- building ID, for exampleid=4504235299048514. For more information on obtaining an ID, see the Building ID section. -
fields- list of fields to return in the response. You can use multiple fields separated by commas, for example:items.address- building address.items.adm_div- administrative territory the building belongs to.items.point- building coordinates.items.links- related objects (nearest parking lots, stops, metro stations, and others).items.floors- number of building floors (requires additional key permission).items.structure_info.material- building material (requires additional key permission).items.structure_info.floor_type- floor type in the building (requires additional key permission).items.structure_info.year_of_construction- year of building construction (requires additional key permission).
Request example:
https://catalog.api.2gis.com/3.0/items/byid?id=4504235299048514&fields=items.address,items.adm_div,items.point,items.links,items.floors,items.structure_info.material,items.structure_info.floor_type,items.structure_info.year_of_construction&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.21070",
"code": 200,
"issue_date": "20260730"
},
"result": {
"items": [
{
"address": {
"building_id": "4504235299048514",
"components": [
{
"number": "12",
"street": "Кадашёвская набережная",
"street_id": "4504338361755723",
"type": "street_number"
}
],
"postcode": "119017"
},
"address_name": "Кадашёвская набережная, 12",
"adm_div": [
{
"id": "1",
"name": "Россия",
"type": "country"
},
{
"id": "5349042514588558",
"name": "Москва",
"type": "region"
},
{
"city_alias": "moscow",
"flags": {
"is_default": true,
"is_region_center": true
},
"id": "4504222397630173",
"is_default": true,
"name": "Москва",
"type": "city"
},
{
"id": "4504209512726534",
"name": "Якиманка",
"type": "district"
}
],
"floors": {
"ground_count": 5,
"underground_count": 0
},
"full_name": "Москва, Кадашёвская набережная, 12",
"id": "4504235299048514",
"links": {
"attractions": [
{
"description": "Концепция создания стены с разноразмерными окнами, в которых находятся картины, отсылает к образу и структуре коллекций художественных искусств конца XIX века, когда ценились не только изображаемые на полотнах произведения искусства, но и роскошные массивные рамы, в которых они размещались.<br>\n<br>Рамы окон выполнены из мраморизованного известняка. Произведения искусства нанесены на внешний слой остекления с помощью цифровой печати.",
"id": "70030076925652730",
"name": "Стена с окнами-картинами",
"subtype_name": "стрит-арт"
},
{
"description": "Концепция создания стены с разноразмерными окнами, в которых находятся картины, отсылает к образу и структуре коллекций художественных искусств конца XIX века, когда ценились не только изображаемые на полотнах произведения искусства, но и роскошные массивные рамы, в которых они размещались.<br>\n<br>Рамы окон выполнены из мраморизованного известняка. Произведения искусства нанесены на внешний слой остекления с помощью цифровой печати.",
"id": "70030076814479595",
"name": "Стена с окнами-картинами",
"subtype_name": "стрит-арт"
}
],
"branches": {
"count": 4
},
"entrances": [
{
"geometry": {
"normals": [
"LINESTRING(37.466208 56.732023,37.619066 55.743775)"
],
"points": [
"POINT(37.619065988873906 55.743775215098729)"
],
"vectors": [
"LINESTRING(37.619052 55.743865,37.619066 55.743775)"
]
},
"id": "70030076839249258",
"is_primary": true,
"is_visible_on_map": true
}
],
"nearest_metro": [
{
"distance": 700,
"id": "4504385606391044"
},
{
"distance": 700,
"id": "4504385606385753"
},
{
"distance": 950,
"id": "4504385606390696"
},
{
"distance": 950,
"id": "4504385606385767"
},
{
"distance": 1400,
"id": "4504385606385675"
},
{
"distance": 1400,
"id": "4504385606388241"
},
{
"distance": 1400,
"id": "4504385606388498"
},
{
"distance": 1600,
"id": "4504385606385818"
},
{
"distance": 1600,
"id": "4504385606385667"
},
{
"distance": 1800,
"id": "4504385606391049"
},
{
"distance": 1800,
"id": "4504385606385733"
},
{
"distance": 1800,
"id": "4504385606391057"
},
{
"distance": 1800,
"id": "4504385606385704"
},
{
"distance": 1900,
"id": "4504385606389140"
},
{
"distance": 1900,
"id": "4504385606389139"
},
{
"distance": 1900,
"id": "4504385606388294"
},
{
"distance": 2000,
"id": "4504385606385779"
},
{
"distance": 2000,
"id": "4504385606391042"
}
],
"nearest_parking": [
{
"id": "70030076990983885"
},
{
"id": "70030077073807032"
},
{
"id": "70030077073802885"
},
{
"id": "70030076990984309"
},
{
"id": "70030077126714948"
},
{
"id": "70030076996775411"
},
{
"id": "70030077063656803"
},
{
"id": "70030077073802519"
},
{
"id": "70030076514195960"
},
{
"id": "70030077073809493"
},
{
"id": "70030076352870287"
},
{
"id": "70030076443710476"
},
{
"id": "70030076323300649"
},
{
"id": "70030076158514901"
},
{
"id": "70030076129033271"
},
{
"id": "70030076158514956"
},
{
"id": "70030076795826052"
}
],
"nearest_stations": [
{
"color": "#FFDF05",
"comment": "Калининская линия",
"distance": 700,
"id": "4504385606391044",
"name": "Третьяковская",
"route_logo": "metro_moscow_8",
"route_types": [
"metro"
]
},
{
"color": "#EA6A00",
"comment": "Калужско-Рижская линия",
"distance": 700,
"id": "4504385606385753",
"name": "Третьяковская",
"route_logo": "metro_moscow_6",
"route_types": [
"metro"
]
},
{
"color": "#758190",
"comment": "Серпуховско-Тимирязевская линия",
"distance": 950,
"id": "4504385606390696",
"name": "Полянка",
"route_logo": "metro_moscow_9",
"route_types": [
"metro"
]
}
]
},
"name": "Кадашёвская набережная, 12",
"point": {
"lat": 55.743142,
"lon": 37.618706
},
"purpose_name": "Музей",
"structure_info": {
"floor_type": "Железобетонные",
"material": "Кирпичный",
"year_of_construction": 2024
},
"type": "building"
}
],
"total": 1
}
}
Obtaining organization information
To obtain information about an organization, send a GET request to /3.0/items/byid with the following parameters:
-
id- organization ID, for exampleid=70000001018276833. For more information on obtaining an ID, see the Organization ID section. -
fields- list of fields to return in the response. You can use multiple fields separated by commas, for example:items.rubrics- organization categories.items.brand- brand the organization belongs to.items.contact_groups- organization contacts (requires additional key permission).items.schedule,items.schedule_special- organization working hours.
Request example:
https://catalog.api.2gis.com/3.0/items/byid?id=70000001018276833&fields=items.rubrics,items.brand,items.contact_groups,items.schedule,items.schedule_special&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260714"
},
"result": {
"items": [
{
"address_comment": "6 этаж",
"address_name": "Театральный проезд, 5 ст1",
"brand": {
"branch_count": 5,
"extension": "кинотеатр",
"id": "70000001024532101",
"name": "Формула Кино"
},
"contact_groups": [
{
"contacts": [
{
"type": "phone",
"text": "+7 (495) 795-37-95",
"value": "+74957953795"
},
{
"type": "website",
"text": "formulakino.ru",
"url": "https://formulakino.ru",
"value": "https://formulakino.ru"
},
{
"type": "email",
"text": "info@formulakino.ru",
"value": "info@formulakino.ru"
}
]
}
],
"id": "70000001018276833",
"name": "Формула Кино, кинотеатр",
"rubrics": [
{
"alias": "kinoteatry",
"id": "192",
"kind": "primary",
"name": "Кинотеатры",
"parent_id": "2",
"short_id": 192
}
],
"schedule": {
"Fri": {
"working_hours": [
{
"from": "10:00",
"to": "03:30"
}
]
},
"Mon": {
"working_hours": [
{
"from": "10:00",
"to": "02:30"
}
]
},
"Sat": {
"working_hours": [
{
"from": "10:00",
"to": "03:30"
}
]
},
"Sun": {
"working_hours": [
{
"from": "10:00",
"to": "02:30"
}
]
},
"Thu": {
"working_hours": [
{
"from": "10:00",
"to": "03:30"
}
]
},
"Tue": {
"working_hours": [
{
"from": "10:00",
"to": "02:30"
}
]
},
"Wed": {
"working_hours": [
{
"from": "10:00",
"to": "02:30"
}
]
}
},
"schedule_special": [
{
"date": "2026-07-20",
"working_hours": [
{
"from": "12:00",
"to": "22:00"
}
]
}
],
"type": "branch"
}
],
"total": 1
}
}
Obtaining parking lot information
To obtain information about a parking lot, send a GET request to /3.0/items/byid with the following parameters:
-
id- parking lot ID, for example4504127908682102. For more information on obtaining an ID, see the Parking lot ID section. -
fields- list of fields to return in the response. You can use multiple fields separated by commas, for example:items.is_paid- whether the parking lot is paid.items.paving_type- parking lot surface type.items.level_count- number of parking lot levels.items.capacity- parking lot capacity.
Request example:
https://catalog.api.2gis.com/3.0/items/byid?id=4504127908682102&fields=items.is_paid,items.paving_type,items.level_count,items.capacity&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260714"
},
"result": {
"items": [
{
"address_name": "площадь Революции, 3",
"building_name": "Парковка ТЦ Охотный ряд",
"capacity": {
"special_spaces": [
{
"count": "12",
"name": "Для инвалидов",
"type": "handicapped"
}
],
"total": "140"
},
"full_name": "Москва, Парковка ТЦ Охотный ряд",
"id": "4504127908682102",
"is_paid": true,
"level_count": 4,
"name": "Парковка ТЦ Охотный ряд",
"paving_type": "asphalt",
"purpose_name": "Подземное сооружение",
"type": "branch"
}
],
"total": 1
}
}