Документация
Справочник JavaScript API
2.1.65 (текущая версия)
collection
interactivityModel
Интерфейсы

Режимы загрузки данных

Менеджер загружает данные только для видимой области карты. При этом поддерживаются два режима загрузки данных:

  • менеджер загружает данные сразу для всей видимой области – на сервер отправляется один запрос для всей области;
  • менеджер загружает данные отдельно по тайлам – на сервер отправляются отдельные запросы для тайлов, попадающих в видимую область.

Какой режим будет использоваться – устанавливает разработчик при создании менеджера, через параметр splitRequests. Параметр может принимать два значения:

  • true (по умолчанию) – данные будут запрашиваться для всей области сразу;
  • false – данные будут запрашиваться по тайлам.

Ниже приведена таблица с описанием режимов загрузки.

Режим загрузки данныхОписание

splitRequests = false (по умолчанию)

Менеджер запрашивает данные сразу для всей видимой области карты.

Преимущества

  • Позволяет уменьшить число запросов к серверу.

Недостатки

  • Необходимо формировать ответ сервера динамически.
  • Организовать серверное кэширование данных сложнее , чем при splitRequests = true.

Пример запроса

GET https://my-server.ru/?bbox=55.02,36.42,55.12,36.94&callback=myCallback_55.02_36.42_55.12_36.94

splitRequests = true

Менеджер запрашивает данные для области по тайлам.

Преимущества

  • Для каждого тайла можно заранее сформировать ответ сервера.
  • Несложно организовать серверное кэширование данных.

Недостатки

  • Для каждого тайла серверу отправляется отдельный запрос. Это может привести к сильной загруженности сервера и увеличению времени загрузки данных при плохом качестве связи.

Пример запросов

GET https://server.ru/?x=622&y=319&z=10&callback=myCallback_x_622_y_319_z_10 
GET https://server.ru/?x=622&y=321&z=10&callback=myCallback_x_622_y_321_z_10  
GET https://server.ru/?x=622&y=322&z=10&callback=myCallback_x_622_y_322_z_10
... 

Режим загрузки данных влияет на частоту обращений к серверу, а также на скорость передачи данных. Кроме того, в зависимости от выбранного режима на сервере может быть по-разному организована структура хранения данных. В разделе Разработка серверной части:

  • – рассмотрены форматы запросов, которые менеджер будет отправлять на сервер при разных режимах;
  • – приведены рекомендации по проектированию серверной архитектуры.