Get object by IP
Catalog of objects (3.0)
Geocoding by IP
Performs geocoding by IP. If the IP-address matches the coordinate, but the geo object is not found at this point, the coordinate is returned.
query Parameters
ip required | string Example: ip=194.226.82.50 IP-address. IPv4 and IPv6 notations are allowed. |
key required | string Unique key of API user. |
locale | string Examples:
The locale from which the search is performed and the results are given.
|
type | Array of strings Examples:
Types of geoobjects to search among. When passing multiple types, the less relevant results of some types may be replaced by the more relevant results of other types. The types are separated by commas. The value 'adm_div `is an alias for all 'adm_div' types.* 'simultaneously. List of available types:
|
fields | Array of strings Examples:
Additional fields to be displayed in the response should be separated by commas. Fields labeled
The list of fields with additional information on the place:
The list of command boxes:
|
lon | string Examples:
Longitude of the point - center of the search area. |
lat | string Examples:
Latitude of the point — center of the search area. |
point | string Examples:
A center of the search area (point coordinates in the |
radius | integer >= 0 Default: 250 Search radius in meters. |
point1 | string Examples:
The coordinates of the upper left vertex of a rectangular area limiting the search results in the |
point2 | string Examples:
The coordinates of the lower right vertex of a rectangular area limiting the search results in the |
polygon | string Examples:
Polygon in WKT format. |
page | integer [ 1 .. 1000000 ] Default: 1 The number of the requested page. |
page_size | integer [ 1 .. 50 ] Default: 20 Number of search results displayed on one page. |
has_photos | boolean Filter by availability of photos. Takes the true or false values. |
has_rating | boolean Filter by availability of rating on flamp.ru. Takes the true or false values. |
has_reviews | boolean Filter by availability of reviews on flamp.ru. Takes the true or false values. |
has_site | boolean Filter by availability of website. Takes the true or false values. |
Responses
Response Schema: application/json
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 |
Response samples
- 200
- 400
- 403
- 404
- 500
{- "result": {
- "context_rubrics": [
- {
- "id": "string",
- "name": "string",
- "group": 0,
- "caption": "string"
}
], - "search_attributes": {
- "is_partial": true,
- "out_viewport": [
- {
- "latitude": 55.97851125831795,
- "longitude": 29.13375591576512
}, - {
- "latitude": 55.97851125831795,
- "longitude": 29.13375591576512
}, - {
- "latitude": 55.97851125831795,
- "longitude": 29.13375591576512
}, - {
- "latitude": 55.97851125831795,
- "longitude": 29.13375591576512
}
], - "is_nearby_requested": true,
- "is_remote_requested": true,
- "drag_bound": [
- {
- "longitude": 29.13375591576512,
- "latitude": 55.97851125831795
}, - {
- "longitude": 29.13375591576512,
- "latitude": 55.97851125831795
}, - {
- "longitude": 29.13375591576512,
- "latitude": 55.97851125831795
}, - {
- "longitude": 29.13375591576512,
- "latitude": 55.97851125831795
}
]
}, - "total": 1,
- "items": [
- {
- "id": "141265769336625_f91d4H3777058262347790J0e8g28765",
- "type": "branch",
- "region_id": "123456",
- "segment_id": "123456",
- "full_name": "string",
- "employees_org_count": "up to 15",
- "org": {
- "id": "123456",
- "name": "string",
- "branch_count": "7"
}, - "floor_id": "141832714658709",
- "external_content": [
- {
- "type": "discount",
- "value": "shintop",
- "label": "Open",
}
], - "building_name": "string",
- "marker_alt": 0,
- "timezone_offset": 420,
- "locale": "ru_RU",
- "delivery": [
- {
- "phone": "+7123456789"
}
], - "ski_lift": {
- "type": 0,
- "status": 0
}, - "rubrics": [
- {
- "id": "123456",
- "name": "string",
- "alias": "string",
- "parent_id": "123456",
- "kind": "string"
}
], - "floors": {
- "ground_min_count": 1,
- "ground_count": 1,
- "underground_count": 1
}, - "contact_groups": [
- {
- "name": "Service center",
- "comment": "Multichannel phone number",
- "schedule": {
- "Sun": {
- "working_hours": [
- {
- "from": null,
- "to": null
}
]
}, - "Fri": {
- "working_hours": [
- {
- "from": null,
- "to": null
}
]
}, - "is_24x7": true,
- "date_to": "string",
- "date_from": "string",
- "Wed": {
- "working_hours": [
- {
- "from": null,
- "to": null
}
]
}, - "Thu": {
- "working_hours": [
- {
- "from": null,
- "to": null
}
]
}, - "comment": "Open 24h on holidays",
- "Tue": {
- "working_hours": [
- {
- "from": null,
- "to": null
}
]
}, - "description": "string",
- "Mon": {
- "working_hours": [
- {
- "from": null,
- "to": null
}
]
}, - "Sat": {
- "working_hours": [
- {
- "from": null,
- "to": null
}
]
}
}, - "contacts": [
- {
- "type": "phone",
- "value": "Phone number in international format",
- "text": "Ivanov's e-mail",
- "print_text": "Ivanov's e-mail",
- "comment": "for business correspondence",
- "url": "string"
}
]
}
], - "trade_license": {
- "type": "string",
- "start_date": "string",
- "end_date": "string",
- "legal_form": "string",
- "type_description": "string",
- "director_name": "string",
- "license": "string"
}, - "sources": [
- "string"
], - "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"
}, - "floor_plans": {
- "default_plan_id": "123456",
- "plans": [
- {
- "id": "123456",
- "name": "string"
}
]
}, - "point": "54.991984,82.901886",
- "purpose_name": "string",
- "address": {
- "building_id": "20498230958",
- "postcode": "630007",
- "building_code": "string",
- "building_name": "Sun City",
- "landmark_name": "Zaryadye (a park in Moscow)",
- "makani": "27116 87099",
- "components": [
- {
- "type": "street_number",
- "street": "Krasnyy Prospekt",
- "number": "21/2, bld 7",
- "fias_code": "dcb1bc1b-2324-449a-8b68-03e49ba1f541",
- "okato": "35",
- "oktmo": "35",
- "street_id": "123456"
}
]
}, - "attribute_groups": [
- {
- "attributes": [
- {
- "id": "123456",
- "icon_url": "string",
- "tag": "hotel_room_internet",
- "name": "Free Internet in the rooms"
}
], - "icon_url": "string",
- "name": "Hotel",
- "is_context": true,
- "is_primary": true,
- "rubric_ids": [
- "123456"
]
}
], - "stop_factors": [
- {
- "type": "attribute",
- "name": "Laundry",
- "tag": "hotel_details_laundry"
}
], - "parking": {
- "payment_link": "string"
}, - "context": {
- "servicing_groups": [
- "string"
], - "distance": "3483",
- "is_in_bound": "true",
- "stop_factors": [
- {
- "type": "attribute",
- "name": "Laundry",
- "tag": "hotel_details_laundry"
}
], - "servicing_group": "string"
}, - "geometry": {
- "centroid": "POINT(83.306820839303 54.6230101954005)",
- "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)"
}, - "order_with_cart": [
- {
- "phone": "+7123456789"
}
], - "structure_info": {
- "chs_name": "string",
- "gas_type": "string",
- "is_in_emergency_state": true,
- "apartments_count": 0,
- "project_type": "string",
- "porch_count": 0,
- "floor_type": "string",
- "elevators_count": 0,
- "chs_category": "string",
- "year_of_construction": 0,
- "material": "string"
}, - "reviews": {
- "is_org_reviews": true,
- "general_rating": "4.73",
- "recommendation_count": "12",
- "rating": "4.73",
- "general_review_count": 0,
- "is_reviewable": true,
- "org_review_count": 0,
- "review_count": "32",
- "org_review_count_with_stars": 0,
- "org_rating": "4.73",
- "items": [
- {
- "rating": 5,
- "review_count": 0,
- "recommendation_count": 0,
- "tag": "string",
- "is_reviewable": true
}
], - "general_review_count_with_stars": 0
}, - "has_apartments_info": true,
- "name": "the Sunny cafe",
- "is_deleted": true,
- "description": "string",
- "itin": "1234567890",
- "schedule": {
- "Sun": {
- "working_hours": [
- {
- "from": "09:00",
- "to": "17:00"
}
]
}, - "Fri": {
- "working_hours": [
- {
- "from": "09:00",
- "to": "17:00"
}
]
}, - "is_24x7": true,
- "date_to": "string",
- "date_from": "string",
- "Wed": {
- "working_hours": [
- {
- "from": "09:00",
- "to": "17:00"
}
]
}, - "Thu": {
- "working_hours": [
- {
- "from": "09:00",
- "to": "17:00"
}
]
}, - "comment": "Open 24h on holidays",
- "Tue": {
- "working_hours": [
- {
- "from": "09:00",
- "to": "17:00"
}
]
}, - "description": "string",
- "Mon": {
- "working_hours": [
- {
- "from": "09:00",
- "to": "17:00"
}
]
}, - "Sat": {
- "working_hours": [
- {
- "from": "09:00",
- "to": "17:00"
}
]
}
}, - "address_comment": "office 413",
- "search_attributes": {
- "suggest_parts": [
- {
- "text": "string",
- "is_suggested": true
}
], - "suggested_text": "string",
- "dgis_address_details": {
- "apartment": "15",
- "precision": "string",
- "address": "12",
- "entrance": "1"
}
}, - "alias": "shintop_set_avtomarketov",
- "flags": {
- "temporary_closed": "string",
- "temporary_closed_parameters": [
- {
- "type": "string",
- "name": "string",
- "value": "string"
}
], - "has_model": { },
- "photos": true,
- "is_default": true,
- "is_region_center": true,
- "is_district_area_center": true
}, - "city_alias": "novosibirsk",
- "is_routing_available": true,
- "links": {
- "nearest_metro": [
- {
- "id": "123456",
- "distance": 500
}
], - "airports": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "name": "Tolmachevo airport",
- "additional_info": "Airport, Ob-4"
}
]
}, - "railway_terminals": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "additional_info": "Shirokaya Street, 26a",
- "name": "Novosibirsk-Western, railway station"
}
]
}, - "database_entrances": [
- {
- "id": "123456",
- "is_visible_in_ui": true,
- "entrance_display_name": "string",
- "relative_geometry": {
- "direction": 0,
- "dx": 0,
- "dy": 0
}, - "is_primary": true,
- "building_number": "string",
- "entity_number": "string",
- "has_poi": true,
- "geometry": {
- "points": [
- "string"
], - "vectors": [
- "string"
], - "normals": [
- "string"
]
}, - "apartments_info": {
- "calculated": true,
- "floors": [
- {
- "name": null,
- "apartments": null
}
]
}, - "entity_name": "string",
- "comment": "string",
- "name": "string",
- "is_visible_on_map": true
}
], - "attractions": [
- {
- "id": "123456",
- "subtype_name": "Fountain",
- "name": "Fountain in Narymsky public garden",
- "authors": "string",
- "dates": "string",
- "description": "string"
}
], - "parking": [
- {
- "id": "123456",
- "name": "Underground Parking, Sun City",
- "purpose": "string",
- "capacity": "string",
- "is_paid": true,
- "comment": "50 rub per hour, first 2 hours free."
}
], - "branches": {
- "items": [
- {
- "id": "123_24J2I19H1J0fghdw7GJ0JJ16153",
- "org_id": "string",
- "name": "string",
- "additional_info": "string",
- "contacts": [
- {
- "type": null,
- "value": null,
- "text": null,
- "print_text": null,
- "comment": null,
- "url": null
}
]
}
], - "count": 1,
- "allowed_for_reviews_count": 0
}, - "servicing": {
- "items": [
- {
- "id": "123_24J2I19H1J0fghdw7GJ0JJ16153",
- "org_id": "string",
- "name": "string",
- "additional_info": "string",
- "contacts": [
- {
- "type": null,
- "value": null,
- "text": null,
- "print_text": null,
- "comment": null,
- "url": null
}
]
}
], - "count": 1,
- "allowed_for_reviews_count": 0
}, - "landmarks": [
- {
- "id": "123456",
- "type": "station_platform",
- "subtype": "string",
- "station_id": "123456",
- "name": "string",
- "entrance_display_name": "string",
- "distance": 0,
- "azimuth": 360
}
], - "seaports": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "name": "Marine passenger terminal",
- "additional_info": "Marine Glory square, 1"
}
]
}, - "nearest_platforms": [
- {
- "id": "123456",
- "route_types": [
- "string"
], - "transition_type": "string",
- "heading_to": "Nakhabino",
- "name": "Krasniy Prospekt metro station",
- "comment": "Leninskaya line",
- "color": "#D10000",
- "route_logo": "string"
}
], - "entrances": [
- {
- "id": "123456",
- "entrance_display_name": "string",
- "entity_number": "string",
- "geometry": {
- "vectors": [
- "string"
], - "normals": [
- "string"
], - "points": [
- "string"
]
}, - "comment": "string",
- "is_visible_on_map": true,
- "entity_name": "string",
- "is_visible_in_ui": true,
- "is_primary": true
}
], - "bus_terminals": {
- "items": [
- {
- "id": "123456",
- "additional_info": "Krasnyy Prospekt, 4",
- "name": "Bus station, Novosibirsk"
}
], - "count": 0
}, - "hotels": {
- "count": 0,
- "items": [
- {
- "id": "123456",
- "name": "Aquarius, Motel",
- "additional_info": "Mira St, 18a bld1"
}
]
}, - "river_ports": {
- "items": [
- {
- "id": "123456",
- "name": "Moscow North river terminal",
- "additional_info": "Leningrad highway, 51"
}
], - "count": 0
}, - "nearest_parking": [
- {
- "id": "123456"
}
], - "providers": {
- "items": [
- {
- "id": "123_24J2I19H1J0fghdw7GJ0JJ16153",
- "org_id": "string",
- "name": "string",
- "additional_info": "string",
- "contacts": [
- {
- "type": null,
- "value": null,
- "text": null,
- "print_text": null,
- "comment": null,
- "url": null
}
]
}
], - "count": 1,
- "allowed_for_reviews_count": 0
}, - "nearest_stations": [
- {
- "id": "123456",
- "entrance": {
- "id": "123456",
- "name": "string",
- "entrance_display_name": "string",
- "geometry": {
- "centroid": "POINT(83.306820839303 54.6230101954005)",
- "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)"
}
}, - "name": "Krasniy Prospekt metro station",
- "comment": "Leninskaya line",
- "route_logo": "string",
- "distance": 0,
- "color": "#D10000",
- "internal_transition": true,
- "route_types": [
- "string"
]
}
]
}, - "address_name": "Dimitrov Avenue, 7",
- "ev_charging_station": {
- "connectors": [
- {
- "type": "string",
- "price": 0,
- "status": 0,
- "power": 0
}
], - "aggregate": {
- "power": 0,
- "is_active": true,
- "is_busy": true,
- "connectors_free": 0,
- "connectors_total": 0
}
}, - "name_ex": {
- "extension": "cafe",
- "legal_name": "LLC Sunny",
- "addition": "string",
- "description": "Warehouse",
- "short_name": "Sunny",
- "primary": "Sunny"
}, - "adm_div": [
- {
- "id": "123456",
- "type": "city",
- "caption": "string",
- "name": "Ust-Kamenogorsk",
- "is_default": true,
- "flags": {
- "temporary_closed": "string",
- "temporary_closed_parameters": [
- {
- "type": "string",
- "name": "string",
- "value": "string"
}
], - "has_model": { },
- "photos": true,
- "is_default": true,
- "is_region_center": true,
- "is_district_area_center": true
}, - "city_alias": "novosibirsk",
- "detailed_subtype": "poselok"
}
], - "full_address_name": "Novosibirsk, Dimitrov Avenue, 7"
}
]
}, - "meta": {
- "code": 200,
- "api_version": "dev",
- "issue_date": "string"
}
}