2ГИС Про | Загрузка данных по API | Справочник API | 2GIS Documentation
2ГИС Про
Карты
Поиск
Навигация
2ГИС Про
2ГИС Линза
Личный кабинет
On‑Premise
ру
en

Справочник API

Documentation Powered by ReDoc

Urbi.Geo.Push.Api (v1)

DynamicAsset

Actions to work with dynamic assets

Get dynamic asset metadata

Get dynamic asset metadata

Sample request:

GET /dynamic_asset/user_dyn_pRsBtqGECTpwKqDkCzow
Authorizations:
Bearer
path Parameters
assetId
required
string [ 1 .. 200 ] characters

Dynamic asset ID

header Parameters
X-Brand
required
string
Default: 2gis

Responses

Response Schema: application/json
required
Array of objects (AssetAttributeGroup)

Attribute groups

geometry_dimension
required
string (GeometryDimension)
Enum: "point" "line" "polygon"
id
required
string [ 1 .. 200 ] characters

ID

name
required
string [ 1 .. 100 ] characters

Name

description
string or null [ 1 .. 500 ] characters

Description

Array of objects or null (AttributeFilter)

Filters

Array of objects or null (AttributeContextFilter)

Context filters

object (DynamicAssetLocalizations)
Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null

Response samples

Content type
application/json
{
  • "id": "user_dyn_zq3ZJxPdT0i1vDAvvyWkgQ",
  • "name": "Road events",
  • "description": "Information on various incidents affecting road traffic. The data includes details about roadworks, accidents, temporary traffic restrictions, weather conditions, traffic jams, and other events that may impact road safety and accessibility.",
  • "geometry_dimension": "point",
  • "attribute_groups": [
    • {
      • "name": "Key features",
      • "attributes": [
        • {
          • "id": "Time",
          • "type": "date_time",
          • "caption": "Time of event",
          • "localizations": {
            }
          },
        • {
          • "id": "EventType",
          • "type": "string",
          • "caption": "Event type",
          • "localizations": {
            }
          },
        • {
          • "id": "Status",
          • "type": "string",
          • "caption": "Status",
          • "localizations": {
            }
          },
        • {
          • "id": "WeatherEventType",
          • "type": "string",
          • "caption": "Weather event",
          • "localizations": {
            }
          },
        • {
          • "id": "Duration",
          • "type": "number",
          • "caption": "Duration",
          • "localizations": {
            }
          }
        ],
      • "localizations": {
        • "name": {
          • "ru": "Основные характеристики"
          }
        }
      }
    ],
  • "filters": [
    • {
      • "attribute_id": "Time",
      • "control_type": "date_time_range",
      • "min": 1735664400000,
      • "max": 1743970440000
      },
    • {
      • "attribute_id": "EventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Accident",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Roadwork",
          • "localizations": {
            }
          },
        • {
          • "value": "3",
          • "caption": "Traffic jam",
          • "localizations": {
            }
          },
        • {
          • "value": "4",
          • "caption": "Weather event",
          • "localizations": {
            }
          }
        ]
      },
    • {
      • "attribute_id": "Status",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Actual",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Completed",
          • "localizations": {
            }
          }
        ]
      },
    • {
      • "attribute_id": "Duration",
      • "control_type": "range",
      • "min": 1,
      • "max": 15000
      },
    • {
      • "attribute_id": "WeatherEventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Actual",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Completed",
          • "localizations": {
            }
          }
        ]
      }
    ],
  • "context_filters": [
    • {
      • "context_attribute_id": "EventType",
      • "context_values": [
        • "4"
        ],
      • "attribute_id": "WeatherEventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Rain",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Snow",
          • "localizations": {
            }
          },
        • {
          • "value": "3",
          • "caption": "Glaze ice",
          • "localizations": {
            }
          },
        • {
          • "value": "5",
          • "caption": "Fog",
          • "localizations": {
            }
          }
        ]
      }
    ],
  • "localizations": {
    • "name": {
      • "ru": "Дорожные события"
      },
    • "description": {
      • "ru": "Информация о различных происшествиях, влияющих на дорожное движение. Данные содержат информацию о дорожных работах, авариях, временных ограничениях движения, погодных условиях, заторах и других событиях, способных повлиять на безопасность и проходимость дорог."
      }
    }
}

Create dynamic asset

Create dynamic asset

Sample request:

POST /dynamic_asset
Authorizations:
Bearer
header Parameters
X-Brand
required
string
Default: 2gis
Request Body schema: application/json
geometry_dimension
required
string (GeometryDimension)
Enum: "point" "line" "polygon"
name
required
string [ 1 .. 100 ] characters

Asset name

description
string or null [ 1 .. 500 ] characters

Asset description

Array of objects or null (AssetAttributeGroup)

Attribute groups

Array of objects or null (AttributeFilter)

Filters

Array of objects or null (AttributeContextFilter) <= 100 items

Context filters

asset_group_id
string or null [ 1 .. 200 ] characters

Asset group ID. Determines the library group to place the asset to

object (CreateDynamicAssetRequestLocalizations)

Responses

Response Schema: application/json
asset_id
string or null

Asset ID

task_id
string or null

Task ID

access_token
string or null

Token required to push data to asset

Array of objects or null (UrbiActionError)

Errors (if any)

Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null

Request samples

Content type
application/json
{
  • "geometry_dimension": "point",
  • "name": "Road events",
  • "description": "Information on various incidents affecting road traffic. The data includes details about roadworks, accidents, temporary traffic restrictions, weather conditions, traffic jams, and other events that may impact road safety and accessibility.",
  • "attribute_groups": [
    • {
      • "name": "Key features",
      • "attributes": [
        • {
          • "id": "Time",
          • "type": "date_time",
          • "caption": "Time of event",
          • "localizations": {
            }
          },
        • {
          • "id": "EventType",
          • "type": "string",
          • "caption": "Event type",
          • "localizations": {
            }
          },
        • {
          • "id": "Status",
          • "type": "string",
          • "caption": "Status",
          • "localizations": {
            }
          },
        • {
          • "id": "WeatherEventType",
          • "type": "string",
          • "caption": "Weather event",
          • "localizations": {
            }
          },
        • {
          • "id": "Duration",
          • "type": "number",
          • "caption": "Duration",
          • "localizations": {
            }
          }
        ],
      • "localizations": {
        • "name": {
          • "ru": "Основные характеристики"
          }
        }
      }
    ],
  • "filters": [
    • {
      • "attribute_id": "Time",
      • "control_type": "date_time_range",
      • "min": 1735664400000,
      • "max": 1743970440000
      },
    • {
      • "attribute_id": "EventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Accident",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Roadwork",
          • "localizations": {
            }
          },
        • {
          • "value": "3",
          • "caption": "Traffic jam",
          • "localizations": {
            }
          },
        • {
          • "value": "4",
          • "caption": "Weather event",
          • "localizations": {
            }
          }
        ]
      },
    • {
      • "attribute_id": "Status",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Actual",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Completed",
          • "localizations": {
            }
          }
        ]
      },
    • {
      • "attribute_id": "Duration",
      • "control_type": "range",
      • "min": 1,
      • "max": 15000
      },
    • {
      • "attribute_id": "WeatherEventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Actual",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Completed",
          • "localizations": {
            }
          }
        ]
      }
    ],
  • "context_filters": [
    • {
      • "context_attribute_id": "EventType",
      • "context_values": [
        • "4"
        ],
      • "attribute_id": "WeatherEventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Rain",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Snow",
          • "localizations": {
            }
          },
        • {
          • "value": "3",
          • "caption": "Glaze ice",
          • "localizations": {
            }
          },
        • {
          • "value": "5",
          • "caption": "Fog",
          • "localizations": {
            }
          }
        ]
      }
    ],
  • "localizations": {
    • "name": {
      • "ru": "Дорожные события"
      },
    • "description": {
      • "ru": "Информация о различных происшествиях, влияющих на дорожное движение. Данные содержат информацию о дорожных работах, авариях, временных ограничениях движения, погодных условиях, заторах и других событиях, способных повлиять на безопасность и проходимость дорог."
      }
    }
}

Response samples

Content type
application/json
{
  • "asset_id": "user_dyn_zq3ZJxPdT0i1vDAvvyWkgQ",
  • "task_id": "hBAbF8iZVUKoXXUjJBgKpA",
  • "access_token": "VT8UivWdluDSWdXA"
}

Update dynamic asset metadata

Update dynamic asset metadata

Sample request:

PUT /dynamic_asset
Authorizations:
Bearer
header Parameters
X-Brand
required
string
Default: 2gis
Request Body schema: application/json
id
required
string [ 1 .. 200 ] characters

Asset ID

name
required
string [ 1 .. 100 ] characters

Asset name

description
string or null [ 1 .. 500 ] characters

Asset description

Array of objects or null (AssetAttributeGroup)

Attribute groups

Array of objects or null (AttributeFilter)

Filters

Array of objects or null (AttributeContextFilter) <= 100 items

Context filters

object (CreateDynamicAssetRequestLocalizations)

Responses

Response Schema: application/json
asset_id
string or null

Asset ID

task_id
string or null

Task ID

access_token
string or null

Token required to push data to asset

Array of objects or null (UrbiActionError)

Errors (if any)

Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null

Request samples

Content type
application/json
{
  • "id": "user_dyn_zq3ZJxPdT0i1vDAvvyWkgQ",
  • "name": "Road events",
  • "description": "Information on various incidents affecting road traffic. The data includes details about roadworks, accidents, temporary traffic restrictions, weather conditions, traffic jams, and other events that may impact road safety and accessibility.",
  • "attribute_groups": [
    • {
      • "name": "Key features",
      • "attributes": [
        • {
          • "id": "Time",
          • "type": "date_time",
          • "caption": "Time of event",
          • "localizations": {
            }
          },
        • {
          • "id": "EventType",
          • "type": "string",
          • "caption": "Event type",
          • "localizations": {
            }
          },
        • {
          • "id": "Status",
          • "type": "string",
          • "caption": "Status",
          • "localizations": {
            }
          },
        • {
          • "id": "WeatherEventType",
          • "type": "string",
          • "caption": "Weather event",
          • "localizations": {
            }
          },
        • {
          • "id": "Duration",
          • "type": "number",
          • "caption": "Duration",
          • "localizations": {
            }
          }
        ],
      • "localizations": {
        • "name": {
          • "ru": "Основные характеристики"
          }
        }
      }
    ],
  • "filters": [
    • {
      • "attribute_id": "Time",
      • "control_type": "date_time_range",
      • "min": 1735664400000,
      • "max": 1743970440000
      },
    • {
      • "attribute_id": "EventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Accident",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Roadwork",
          • "localizations": {
            }
          },
        • {
          • "value": "3",
          • "caption": "Traffic jam",
          • "localizations": {
            }
          },
        • {
          • "value": "4",
          • "caption": "Weather event",
          • "localizations": {
            }
          }
        ]
      },
    • {
      • "attribute_id": "Status",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Actual",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Completed",
          • "localizations": {
            }
          }
        ]
      },
    • {
      • "attribute_id": "Duration",
      • "control_type": "range",
      • "min": 1,
      • "max": 15000
      },
    • {
      • "attribute_id": "WeatherEventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Actual",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Completed",
          • "localizations": {
            }
          }
        ]
      }
    ],
  • "context_filters": [
    • {
      • "context_attribute_id": "EventType",
      • "context_values": [
        • "4"
        ],
      • "attribute_id": "WeatherEventType",
      • "control_type": "check_box_list",
      • "items": [
        • {
          • "value": "1",
          • "caption": "Rain",
          • "localizations": {
            }
          },
        • {
          • "value": "2",
          • "caption": "Snow",
          • "localizations": {
            }
          },
        • {
          • "value": "3",
          • "caption": "Glaze ice",
          • "localizations": {
            }
          },
        • {
          • "value": "5",
          • "caption": "Fog",
          • "localizations": {
            }
          }
        ]
      }
    ],
  • "localizations": {
    • "name": {
      • "ru": "Дорожные события"
      },
    • "description": {
      • "ru": "Информация о различных происшествиях, влияющих на дорожное движение. Данные содержат информацию о дорожных работах, авариях, временных ограничениях движения, погодных условиях, заторах и других событиях, способных повлиять на безопасность и проходимость дорог."
      }
    }
}

Response samples

Content type
application/json
{
  • "asset_id": "user_dyn_zq3ZJxPdT0i1vDAvvyWkgQ",
  • "task_id": "hBAbF8iZVUKoXXUjJBgKpA",
  • "access_token": "VT8UivWdluDSWdXA"
}

Push data to dynamic asset

Push data to dynamic asset

Sample request:

PUT /dynamic_asset/user_dyn_pRsBtqGECTpwKqDkCzow/data
Authorizations:
Bearer
path Parameters
assetId
required
string [ 1 .. 200 ] characters

Dynamic asset ID

header Parameters
X-Brand
required
string
Default: 2gis
Request Body schema: application/json

Payload in GeoJSON format

type
required
string (GeoJsonType)
Enum: "Geometry" "Feature" "FeatureCollection"

GeoJson data type

Members:

  • Geometry - Geometry type
  • Feature - Feature type
  • FeatureCollection - FeatureCollection type

Array of objects or null (GeoJsonFeature) [ 1 .. 100 ] items

Responses

Response Schema: application/json
object or null

Errors grouped by object ID

Response Schema: application/json
object or null

Errors grouped by object ID

Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null

Request samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    • {
      • "id": "1",
      • "type": "Feature",
      • "geometry": {
        • "type": "Polygon",
        • "coordinates": [
          • [
            ]
          ]
        },
      • "properties": {},
      • "localizations": {
        • "Model": {
          • "ru": "Форд Мустанг"
          }
        }
      }
    ]
}

Response samples

Content type
application/json
{
  • "errors_by_id": {
    • "1": [
      • "Invalid geometry"
      ]
    }
}

Delete selected objects from dynamic asset

Delete selected objects from dynamic asset

Sample request:

DELETE /dynamic_asset/user_dyn_pRsBtqGECTpwKqDkCzow/data
Authorizations:
Bearer
path Parameters
assetId
required
string [ 1 .. 200 ] characters

Dynamic asset ID

header Parameters
X-Brand
required
string
Default: 2gis
Request Body schema: application/json

Objects to delete

Array ([ 1 .. 100 ] items)
string

Responses

Response Schema: application/json
string
Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null

Request samples

Content type
application/json
[
  • "1",
  • "2",
  • "3"
]

Response samples

Content type
application/json
"string"

Delete all objects from dynamic asset

Delete all objects from dynamic asset

Sample request:

DELETE /dynamic_asset/user_dyn_pRsBtqGECTpwKqDkCzow/data/all
Authorizations:
Bearer
path Parameters
assetId
required
string [ 1 .. 200 ] characters

Dynamic asset ID

header Parameters
X-Brand
required
string
Default: 2gis

Responses

Response Schema: application/json
string
Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null
Response Schema: application/json
error
string or null

Response samples

Content type
application/json
"string"