Разработка серверной части

Пример запроса, который отправит менеджер:

GET https://my-server.ru/?bbox=55.3589,36.2109,56.1519,39.0234&callback=myCallback_55_3589_36_2109_56_1519_39_0234

где:

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

Чтобы менеджер запрашивал данные таким способом, необходимо при создании менеджера:

• в параметре urlTemplate использовать подстановку %b.

Например:

// Создадим менеджер и передадим ему шаблон URL данных.
// В шаблоне будем использовать подстановку %b, которая
// заменяется на массив географических координат области (подробнее о подстановках).
var loadingObjectManager = new ymaps.LoadingObjectManager('https://server.ru/?bbox=%b', {
        // Шаблон названия callback-функции, в которую сервер должен обернуть ответ.
        paddingTepmlate: "myCallback_%b"
    });

Рекомендации по размещению данных на сервере

При таком формате запроса рекомендуется размещать данные в пространственной базе данных. В качестве пространственного индекса можно установить поле, содержащее широту и долготу углов области. По такому индексу легко получить выборку объектов, входящих в нужную область.

Пример запроса, который отправит менеджер за данными:

GET https://server.ru/?tileBounds=615,319,622,322&z=10&callback=myCallback_615_319_622_322_10 

где:

• tileBounds – номера левого верхнего и правого нижнего тайлов;
• z — коэффициент масштабирования;
• callback – имя функции, в которую сервер должен обернуть ответ. Подробнее см. в разделе Формат ответа сервера.

Чтобы менеджер запрашивал данные таким способом, необходимо:

• в параметре urlTemplate использовать любые из подстановок: %t, %c, %x, %y, %z (подробнее о подстановках).

Например:

// Создадим менеджер и передадим шаблон URL с подстановками %t и %z (подробнее о подстановках).
// %t – заменяется на последовательность номеров угловых тайлов области. Номера перечисляются через запятую.
// %z – заменяется на уровень масштабирования.
var loadingObjectManager = new ymaps.LoadingObjectManager('https://server.ru/?tileBounds=%t&z=%z', {
        // Шаблон названия callback-функции, в которую сервер должен обернуть ответ.
        paddingTemplate: 'myCallback_%t_%z'
    });

Рекомендации по размещению данных на сервере

При таком формате запроса можно настроить в базе составной индекс с ключами x, y и z, где x – номер тайла по X, y – номер тайла по Y и z – коэффициент масштабирования (подробнее о составных индексах). Тогда можно получить выборку из базы, опираясь на сформированный ключ, аналогично работе с географическими координатами.

Рекомендации по кэшированию ответа

В зависимости от действий пользователя на карте размеры запрашиваемых областей будут разными. По этой причине оптимальнее кэшировать выборку из базы потайлово. Поскольку серверу передается параметр tileBounds, содержащий номера первого и последнего тайлов области, нетрудно определить номера остальных тайлов, входящих в эту область. Тогда при запросе данных для некоторой тайловой области нужно «склеить» ответ из данных по каждому тайлу в составе области и отправить ответ на клиент.

Существует множество инструментов, позволяющих реализовать кэширование данных на сервере (например memcached или redis). В качестве ключа кэширования можно использовать параметры x, y, z.

Примеры запросов, которые менеджер будет отправлять на сервер:

GET https://server.ru/?bbox=55.5587,36.2109,55.7574,36.5625&callback=myCallback_55_5587_36_2109_55_7574_36_5625
GET https://server.ru/?bbox=55.7574,36.2109,55.9552,36.5625&callback=myCallback_55_7574_36_2109_55_9552_36_5625
GET https://server.ru/?bbox=55.3589,36.2109,55.5587,36.5625&callback=myCallback_55_3589_36_2109_55_5587_36_5625 
...

где:

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

Чтобы менеджер запрашивал данные таким способом, необходимо:

• в параметре urlTemplate использовать подстановку %b (подробнее о подстановках);
• выставить параметр splitRequests в true.

Например:

// Создадим менеджер, который будет запрашивать данные отдельно по тайлам.
var loadingObjectManager = new ymaps.LoadingObjectManager('https://server.ru/?bbox=%b', {
        splitRequests: true,
        paddingTemplate: myCallback_%b
    });

Рекомендации по размещению данных на сервере

В качестве пространственного индекса базы можно установить поле, содержащее географические координаты углов тайла.

Рекомендации по кэшированию

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

Пример запросов, которые будет формировать менеджер:

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
... 

• x – номера тайла по оси X;
• y – номер тайла по оси Y;
• z – коэффициент масштабирования;
• callback – имя функции, в которую сервер должен обернуть ответ. Подробнее см. в разделе Формат ответа сервера.

Чтобы менеджер запрашивал данные таким способом, необходимо:

• в параметре urlTemplate использовать любые из подстановок: %t, %c, %x, %y, %z (подробнее о подстановках);
• выставить параметр splitRequests в true.

Например:

// Создадим менеджер, который будет запрашивать данные отдельно по тайлам.
var loadingObjectManager = new ymaps.LoadingObjectManager('http://server.ru/?%c', {
        splitRequests: true,
        // Такой шаблон доступен только при splitRequests=true.
        paddingTemplate: myCallback_%c 
    });

Рекомендации по размещению данных на сервере

При таком формате запроса можно настроить в базе составной индекс с ключами x, y и z (подробнее о составных индексах).

Рекомендации по кэшированию

Когда клиент запрашивает данные потайлово, он формирует конечное число запросов к серверу (карта состоит из конечного числа тайлов). Чтобы при поступлении нового запроса каждый раз не обращаться к базе данных, для каждого запроса можно кэшировать ответ. В качестве ключей кэширования можно установить параметры запроса: x, y, z. Для реализации серверного кэширования можно использовать memcached или, например, redis.