Get object by id
Directory of map objects (2.0)
2GIS API Support: api@2gis.ru URL: https://docs.2gis.com/
Getting information about map object
Displays detailed information about the map object by its unique identifier.
query Parameters
key required | string A unique key of API user. |
id required | string Map object ID. |
hash | string Basic hash consisting of 16 characters. It is used to generate statistics and display advertising options. |
locale | string The locale with which the search is performed and given results. |
fields | Array of strings Additional fields to display in the response are separated by commas.
|
Responses
Response Schema: application/jsonapplication/jsontext/xml
application/json
application/json
text/xml
required | object (ObjMeta) Response metadata |
required | object Main result |
Response Schema: application/json
object (ObjMetaBadRequest) Response metadata |
Response Schema: application/json
object (ObjMetaForbidden) Response metadata |
Response Schema: application/json
object (ObjMetaNotFound) Response metadata |
Response Schema: application/json
object (ObjMetaServerError) Response metadata |
https://catalog.api.2gis.com/2.0/geo/get
Response samples
- 200
- 400
- 403
- 404
- 500
Content type
application/json
application/json
text/xml
{- "meta": {
- "api_version": "dev",
- "issue_date": "string",
- "code": 200
}, - "result": {
- "total": 1,
- "items": [
- {
- "id": "141806935212033",
- "type": "adm_div",
- "region_id": "1",
- "segment_id": "123456",
- "fns_code": "35",
- "statistics": {
- "area": 0,
- "length": 0,
- "building_count": 0,
- "filials_count": 1
}, - "caption": "string",
- "fias_code": "dcb1bc1b-2324-449a-8b68-03e49ba1f541",
- "reviews": {
- "is_reviewable_on_flamp": true,
- "items": [
- {
- "tag": "string",
- "is_reviewable": true
}
], - "general_rating": "4.73",
- "general_review_count": 0,
- "general_review_count_with_stars": 0,
- "is_reviewable": true
}, - "oktmo": "35",
- "name": "string",
- "okato": "35",
- "subtype": "string",
- "adm_div": [
- {
- "id": "123456",
- "type": "city",
- "name": "Ust-Kamenogorsk",
- "is_default": true,
- "flags": {
- "is_default": true,
- "is_region_center": true,
- "is_district_area_center": true,
- "temporary_closed": "string",
- "temporary_closed_parameters": [
- {
- "type": "string",
- "value": "string",
- "name": "string"
}
], - "has_model": { },
- "photos": true
}, - "city_alias": "novosibirsk",
- "detailed_subtype": "poselok",
- "caption": "string"
}
], - "sources": [
- "string"
], - "flags": {
- "is_default": true,
- "is_region_center": true,
- "is_district_area_center": true,
- "temporary_closed": "string",
- "temporary_closed_parameters": [
- {
- "type": "string",
- "value": "string",
- "name": "string"
}
], - "has_model": { },
- "photos": true
}, - "city_alias": "novosibirsk",
- "locale": "ru_RU",
- "detailed_subtype": "poselok",
- "dates": {
- "created_at": "2012-04-18T12:08:03.273144+07:00",
- "updated_at": "2012-06-18T11:43:03.273144+07:00",
- "deleted_at": "2013-06-01T11:43:03.273144+07:00"
}, - "point": "54.991984,82.901886",
- "rubrics": [
- {
- "id": "123456",
- "name": "string",
- "alias": "string",
- "parent_id": "123456",
- "kind": "string"
}
], - "context": {
- "distance": 0
}, - "external_content": [
- {
- "type": "photo_album",
- "count": 3,
- "subtype": "common"
}
], - "subtype_specification": "string",
- "search_attributes": {
- "suggest_parts": [
- {
- "is_suggested": true,
- "text": "string"
}
], - "dgis_address_details": {
- "entrance": "1",
- "apartment": "15",
- "precision": "string",
- "address": "12"
}, - "suggested_text": "string"
}, - "is_routing_available": true,
- "description": "string",
- "full_name": "string",
- "links": {
- "hotels": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "name": "Aquarius, Motel",
- "additional_info": "Mira St, 18a bld1"
}
]
}, - "parking": [
- {
- "id": "123456",
- "capacity": "string",
- "is_paid": true,
- "comment": "50 rub per hour, first 2 hours free.",
- "name": "Underground Parking, Sun City",
- "purpose": "string"
}
], - "railway_terminals": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "name": "Novosibirsk-Western, railway station",
- "additional_info": "Shirokaya Street, 26a"
}
]
}, - "servicing": {
- "allowed_for_reviews_count": 0,
- "items": [
- {
- "id": "123_24J2I19H1J0fghdw7GJ0JJ16153",
- "additional_info": "string",
- "contacts": [
- {
- "type": null,
- "comment": null,
- "url": null,
- "value": null,
- "text": null,
- "print_text": null
}
], - "org_id": "string",
- "name": "string"
}
], - "count": 1
}, - "nearest_metro": [
- {
- "id": "123456",
- "distance": 500
}
], - "landmarks": [
- {
- "id": "123456",
- "type": "station_platform",
- "subtype": "string",
- "station_id": "123456",
- "name": "string",
- "entrance_display_name": "string",
- "distance": 0,
- "azimuth": 360
}
], - "nearest_parking": [
- {
- "id": "123456"
}
], - "database_entrances": [
- {
- "id": "123456",
- "relative_geometry": {
- "dy": 0,
- "direction": 0,
- "dx": 0
}, - "entity_number": "string",
- "entity_name": "string",
- "is_visible_in_ui": true,
- "has_poi": true,
- "is_visible_on_map": true,
- "apartments_info": {
- "floors": [
- {
- "name": null,
- "apartments": null
}
], - "calculated": true
}, - "geometry": {
- "vectors": [
- "string"
], - "normals": [
- "string"
], - "points": [
- "string"
]
}, - "building_number": "string",
- "entrance_display_name": "string",
- "comment": "string",
- "name": "string",
- "is_primary": true
}
], - "airports": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "additional_info": "Airport, Ob-4",
- "name": "Tolmachevo airport"
}
]
}, - "attractions": [
- {
- "id": "123456",
- "authors": "string",
- "dates": "string",
- "description": "string",
- "subtype_name": "Fountain",
- "name": "Fountain in Narymsky public garden"
}
], - "branches": {
- "allowed_for_reviews_count": 0,
- "items": [
- {
- "id": "123_24J2I19H1J0fghdw7GJ0JJ16153",
- "additional_info": "string",
- "contacts": [
- {
- "type": null,
- "comment": null,
- "url": null,
- "value": null,
- "text": null,
- "print_text": null
}
], - "org_id": "string",
- "name": "string"
}
], - "count": 1
}, - "river_ports": {
- "items": [
- {
- "id": "123456",
- "name": "Moscow North river terminal",
- "additional_info": "Leningrad highway, 51"
}
], - "count": 0
}, - "bus_terminals": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "additional_info": "Krasnyy Prospekt, 4",
- "name": "Bus station, Novosibirsk"
}
]
}, - "nearest_platforms": [
- {
- "id": "123456",
- "comment": "Leninskaya line",
- "color": "#D10000",
- "route_logo": "string",
- "route_types": [
- "string"
], - "transition_type": "string",
- "heading_to": "Nakhabino",
- "name": "Krasniy Prospekt metro station"
}
], - "entrances": [
- {
- "id": "123456",
- "entrance_display_name": "string",
- "entity_number": "string",
- "is_primary": true,
- "entity_name": "string",
- "is_visible_on_map": true,
- "is_visible_in_ui": true,
- "geometry": {
- "normals": [
- "string"
], - "points": [
- "string"
], - "vectors": [
- "string"
]
}, - "comment": "string"
}
], - "seaports": {
- "items": [
- {
- "id": "123456",
- "name": "Marine passenger terminal",
- "additional_info": "Marine Glory square, 1"
}
], - "count": 0
}, - "providers": {
- "allowed_for_reviews_count": 0,
- "items": [
- {
- "id": "123_24J2I19H1J0fghdw7GJ0JJ16153",
- "additional_info": "string",
- "contacts": [
- {
- "type": null,
- "comment": null,
- "url": null,
- "value": null,
- "text": null,
- "print_text": null
}
], - "org_id": "string",
- "name": "string"
}
], - "count": 1
}, - "nearest_stations": [
- {
- "id": "123456",
- "distance": 0,
- "color": "#D10000",
- "route_logo": "string",
- "name": "Krasniy Prospekt metro station",
- "comment": "Leninskaya line",
- "entrance": {
- "id": "123456",
- "name": "string",
- "entrance_display_name": "string",
- "geometry": {
- "hover": "POLYGON((36.193851601974 51.7466070840044,36.1943391434488 51.7466070840044,36.1943391434488 51.7474670961949,36.193851601974 51.7474670961949,36.193851601974 51.7466070840044))",
- "selection": "POINT(83.306820839303 54.6230101954005)",
- "centroid": "POINT(83.306820839303 54.6230101954005)"
}
}, - "route_types": [
- "string"
], - "internal_transition": true
}
]
}, - "attraction": {
- "id": "141806935212033",
- "subtype_name": "string",
- "name": "string",
- "description": "string",
- "dates": "string",
- "authors": "string"
}, - "geometry": {
- "hover": "POLYGON((36.193851601974 51.7466070840044,36.1943391434488 51.7466070840044,36.1943391434488 51.7474670961949,36.193851601974 51.7474670961949,36.193851601974 51.7466070840044))",
- "selection": "POINT(83.306820839303 54.6230101954005)",
- "centroid": "POINT(83.306820839303 54.6230101954005)"
}
}
]
}
}