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

IMSHOP Retail Protocol (IRP) является объектом интеллектуальной собственности ООО «АЙ ЭМ СОЛЮШНЗ» (IMSHOP) и защищён как объект авторского права. Свидетельство о депонировании произведения № 023-014461 от 16 января 2023 г. подтверждает исключительные права ООО «АЙ ЭМ СОЛЮШНЗ» на данные технологии.

IMSHOP Retail Protocol создан по заказу ООО «АЙ ЭМ СОЛЮШНЗ». Использование IMSHOP Retail Protocol допустимо только при взаимодействии с ООО "АЙ ЭМ СОЛЮШНЗ" и наличии действующего лицензионного договора. Более подробно можно ознакомиться здесь.

Объект «Местоположение» используется в тех случаях, когда 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 — почтовый индекс