export_zones
Чтобы экспортировать геозоны в файл в формате KML или KMZ, используйте метод exchange/export_zones.
Конечная точка
svc=exchange/export_zones¶ms={
"fileName": <text>,
"zones": [
{
"itemId": <long>,
"id": <long>
}
],
"compress": <bool>
}
Метод относится к ресурсоемким запросам, поэтому на него распространяется ограничение на количество одновременно обрабатываемых ресурсоемких запросов в одной сессии. При превышении ограничения возвращается ошибка 1003 с причиной
LIMIT api_concurrent. Список ресурсоемких запросов см. в разделе Ограничения.
Параметры
| Параметр | Описание |
|---|---|
fileName |
Имя файла. |
zones |
Массив геозон. |
itemId |
ID ресурса. |
id |
ID геозоны. |
compress |
Укажите 1 для сжатия файла или 0, чтобы получить несжатый файл. |
Ответ
При успешном выполнении запроса возвращается файл в формате KML или KMZ.
В настоящее время, если ресурс или геозона с указанным ID не найдены на сервере, генерируется ответ в формате XML с именем файла:
Запрос
{"fileName":"export_zones_result","zones":[{"itemId":<nonexisting-resource-id>,"id":<nonexisting-geofence-id>}],"compress":0}
Ответ
<?xml version="1.0" encoding="utf-8"?>
<kml>
<Document>
<name>
export_zones_result
</name>
</Document>
</kml>
При неудачном выполнении возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 1 | Неверный или устаревший SID запроса. |
| 4 | Одна из следующих ошибок:
|
| 6 | Одна из следующих ошибок:
|