Объект «Местоположение»

Объект «Местоположение» используется в тех случаях, когда IMSHOP.IO требуется передать адрес пользователя.
Минимальная точность по умолчанию — город или населённый пункт; остальные поля могут прийти пустыми.
При оформлении заказа с доставкой пользователь вводит полный адрес.

Пример:

{
"fias": "140e31da-27bf-4519-9ea0-6185d681d44e",
"fiasCode": "55000001000000000000000",
"kladr": "5500000100000",
"houseFias": null,
"streetFias": null,
"cityFias": "140e31da-27bf-4519-9ea0-6185d681d44e",
"settlementFias": null,
"areaFias": null,
"regionFias": "05426864-466d-41a3-82c4-11e61cdc98ce",
"value": "г Омск",
"apt": null,
"house": null,
"building": null,
"street": null,
"city": "Омск",
"settlement": null,
"area": null,
"region": "Омская",
"houseKladr": null,
"streetKladr": null,
"cityKladr": "5500000100000",
"settlementKladr": null,
"areaKladr": null,
"regionKladr": "5500000000000",
"lat": "54.9848566",
"lon": "73.3674517",
"zip": "644000"
}

Значения полей:

Наиболее точные известные координаты пользователя.

Если местоположение пользователя известно с точностью до улицы — используется гео - идентификаторы этой улицы.
  • fias — UUID ФИАС
  • fiasCode — иерархический код адреса в ФИАС
  • kladr — идентификатор КЛАДР

Идентификаторы UUID ФИАС для всех известных географических элементов в адресе пользователя.

Регион → Город/Населённый пункт → Улица → Дом
Если адрес пользователя известен с точностью до города, идентификаторы для дома и улицы будут пусты. Если адрес пользователя известен с точностью до улицы, идентификатор дома будет пуст.
  • houseFias — UUID ФИАС для дома
  • streetFias — UUID ФИАС для улицы
  • cityFias — UUID ФИАС для города
  • settlementFias — UUID ФИАС для населённого пункта
  • areaFias — UUID ФИАС для района в регионе
  • regionFias — UUID ФИАС для региона
Квартира не имеет ФИАС-идентификатора, точность ограничивается домом.

Адрес в том виде, как его ввёл пользователь.

  • value — полный адрес
  • apt — квартира
  • house — дом
  • building — корпус или строение
  • street — улица
  • city — город
  • settlement — населённый пункт
  • area — район в регионе
  • region — регион

Идентификаторы КЛАДР для всех известных географических элементов в адресе пользователя.

Регион → Город/Населённый пункт → Улица → Дом
Если адрес пользователя известен с точностью до города, идентификаторы для дома и улицы будут пусты. Если адрес пользователя известен с точностью до улицы, идентификатор дома будет пуст.
  • houseKladr — идентификатор КЛАДР для дома
  • streetKladr — идентификатор КЛАДР для улицы
  • cityKladr — идентификатор КЛАДР для города
  • settlementKladr — идентификатор КЛАДР для населённого пункта
  • areaKladr — идентификатор КЛАДР для района в регионе
  • regionKladr — идентификатор КЛАДР для региона

Координаты пользователя

Если пользователь дал согласие на получение приложением текущего местоположения устройства, будут переданы текущие координаты:
  • lat — широта
  • lon — долгота

Почтовый индекс

  • zip — почтовый индекс