Справочный центр Wialon

set_locale

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

Copied!
svc=render/set_locale&params={"tzOffset":<int>,
			      			  "language":"<text>",
			      			  "flags":<uint>,
			      			  "formatDate":"<text>",
			      			  "density":<uint>}

Параметры

Название Описание
tzOffset Обязательный параметр. Часовой пояс.
language Обязательный параметр. Язык (двухбуквенный код).
formatDate Формат даты и времени (см. ниже). Параметр применяется всегда, поэтому не указывайте его только в том случае, если нужно сбросить текущий формат.
flags Необязательный параметр. Битовая маска опций отрисовки. Два младших бита задают систему мер в виде значения от 0 до 3:

  • 0 — метрическая;
  • 1 — американская;
  • 2 — имперская;
  • 3 — метрическая с галлонами.
Остальные опции отрисовки используют старшие биты и могут быть объединены с системой мер с помощью побитового ИЛИ. Например, чтобы использовать американские единицы измерения (1) вместе с корректировкой координат для Китая (1024), передайте значение 1025.
density Размер тайла (необязательно).

Значение параметра flags полностью заменяет текущие флаги сессии. Если вы отправляете этот запрос только для изменения системы мер, остальные биты сбрасываются. Чтобы сохранить их, включите их в новое значение.

Формат даты и времени:

Параметр Описание
%H Час суток с начальным нулем при необходимости (от “00” до “23”).
%B Полное имя месяца (от “Январь” до “Декабрь”).
%b Сокращенное имя месяца (от “Янв” до “Дек”).
%m Номер месяца с начальным нулем при необходимости (от “01” до “12”).
%l Месяц года (от “1” до “12”).
%P Формат персидского календаря (“01 Фарвардин 1392 00:00:00”).
%A Полное имя дня недели (от “Понедельник” до “Воскресенье”).
%a Сокращенное имя дня недели (от “Пон” до “Вос”).
%E День месяца с начальным нулем при необходимости (от “01” до “31”).
%e День месяца (от “1” до “31”).
%I Час дня с начальным нулем при необходимости (от “01” до “12”).
%M Минуты часа с начальным нулем при необходимости (от “00” до “59”).
%S Секунды минуты с начальным нулем при необходимости (от “00” до “59”).
%p Обозначение A.M./P.M. (“AM” или “PM”).
%Y Полное четырехзначное число года (“1999” или “2008”).
%y Двухзначное число года (“99” или “08”).

Пример:

Copied!
"formatDate":"%Y-%m-%E %H:%M:%S"

Результат:

Copied!
2013-01-26 12:34:56

Плотность:

Значение Размер тайла Коэффициент
1 256*256 1
2 384*384 1.5
3 512*512 2
4 768*768 3
5 1024*1024 4
6 4096*4096 16

Размер по умолчанию — 256*256.

Ответ

Если запрос выполнен успешно, возвращается пустой JSON.

Copied!
{ }

В противном случае возвращается код ошибки. Возможные коды ошибок:

Код Описание
6 Неопределенная ошибка.
4 Неверные входные параметры.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.