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

set_locale

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

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

Параметры

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

  • 0 — метрическая;
  • 1 — американская;
  • 2 — имперская;
  • 3 — метрическая с галлонами.
Остальные опции отрисовки используют старшие биты и могут быть объединены с системой мер с помощью побитового ИЛИ. Например, чтобы использовать американские единицы измерения (1) вместе с корректировкой координат для Китая (1024), передайте значение 1025.
formatDate Формат даты и времени (см. ниже).
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

Плотность:

ЗначениеРазмер тайлаКоэффициент
1256*2561
2378*3781.5
3512*5122
4768*7683
51024*10244

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

Возвращаемый результат

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

Copied!
{ }

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

КодОписание

6

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

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