Определение адреса на карте

В разработке!!!

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

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

Запрос отправляется после того как определился адрес пользователя в через наш сервис подсказок.

Фильтр каталога по магазинам будет работать только если подключен фид остатков, в котором  id оутлетов совпадает с id присылаемых точек в этом ендпоинте.

Для возможности оформить заказ с включенным функционалом адреса на карте в ендпоинте доставок корзины также должны быть корректные типы type доставок (pickup и delivery),  а также должны совпадать id точек для самовывоза.

Формат запроса и пример

Пример

{
	"coords": {
		"latitude": "55.820189166725015",
		"longitude": "37.62089263647795"
	},
	"address": {
		"location": {
			"city": "Москва",
			"cityWithType": "г Москва",
			"region": "Москва",
			"regionWithType": "г Москва",
			"cityFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
			"regionFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
			"streetFiasId": "08617e6d-911e-4cb3-b8cb-351b87f5b8d8",
			"houseFiasId": "1a76c1db-43ef-4a3c-80ff-2a4126fac38e",
			"regionKladrId": "7700000000000",
			"cityKladrId": "7700000000000",
			"streetKladrId": "77000000000076300",
			"houseKladrId": "7700000000007630033",
			"street": "Аргуновская",
			"streetWithType": "ул Аргуновская",
			"streetType": "ул",
			"house": "18",
			"lat": "55.819965",
			"lon": "37.62157",
			"federalDistrict": "Центральный",
			"fiasId": "1a76c1db-43ef-4a3c-80ff-2a4126fac38e",
			"kladrId": "7700000000007630033",
			"postalCode": "129075",
			"valueCity": "г Москва",
			"valueCityFull": "г Москва",
			"valueAddress": "г Москва, ул Аргуновская, д 18",
			"valueAddressFull": "г Москва, ул Аргуновская, д 18",
			"beltwayHit": "IN_MKAD",
			"capitalMarker": "0"
		}
	}

Описание формата

Формат ответа и пример

Пример

{
  "deliveries": [
    {
      "deliveryLocation": {
        "id": "1",
        "title": "Официальный магазин 1",
        "address": "Адрес магазина 1",
        "city": "Москва",
        "lat": "55.82103459558953",
        "lon": "37.622106949294164",
        "price": 0,
        "min": 0,
        "mapIcon": "https://media.discordapp.net/attachments/797048356953260083/1086305227587723354/image.png"
      },
      "locations": [
        {
          "id": "1",
          "title": "Официальный магазин 1",
          "address": "Адрес магазина 1",
          "city": "Москва",
          "lat": "55.82103459558953",
          "lon": "37.622106949294164",
          "price": 0,
          "min": 0,
          "mapIcon": "https://media.discordapp.net/attachments/797048356953260083/1086305227587723354/image.png"
        },
        {
          "id": "2",
          "title": "Официальный магазин 2",
          "address": "Адрес магазина 2",
          "city": "Москва",
          "lat": "55.82029929504126",
          "lon": "37.61991819151923",
          "price": 0,
          "min": 0,
          "mapIcon": "https://media.discordapp.net/attachments/797048356953260083/1086305227587723354/image.png"
        },
        {
          "id": "3",
          "title": "Официальный магазин 3",
          "address": "Адрес магазина 3",
          "city": "Москва",
          "lat": "55.8195398293086",
          "lon": "37.621055407817195",
          "price": 0,
          "min": 0,
          "mapIcon": "https://media.discordapp.net/attachments/797048356953260083/1086305227587723354/image.png"
        },
        {
          "id": "4",
          "title": "Официальный магазин 4",
          "address": "Адрес магазина 4",
          "city": "Москва",
          "lat": "55.82100450114413",
          "lon": "37.61952123769003",
          "price": 0,
          "min": 0,
          "mapIcon": "https://media.discordapp.net/attachments/797048356953260083/1086305227587723354/image.png"
        }
      ]
    }
  ]
}

Описание формата

  • locations — список ПВЗ (МАССИВ ОБЪЕКТОВ ТОЧЕК ПВЗ) если рядом с данными координатами нет магазинов то пустой (также используется для фильтрации каталога если подключен фид остатков)

    • id — идентификатор самовывоза, строка (обязательное поле)

    • title — название, строка (обязательное поле)

    • address — адрес, строка (обязательное поле)

    • city — город, строка (обязательное поле)

    • lat — широта для отображения на карте, строка (обязательное поле)

    • lon — долгота для отображения на карте, строка (обязательное поле)

    • mapIcon — ссылка на кастомную иконку точки

  • deliveryLocation - Магазин из которого будет осуществляться доставка на выбранный адрес и по которому будет отфильтрован каталог (если доставка на адрес невозможна то вернуть null) (1 ОБЪЕКТ ОДНОЙ ТОЧКИ ПВЗ)

    • id — идентификатор самовывоза, строка (обязательное поле)

    • lon — долгота для отображения на карте, строка (обязательное поле)

    • lat — широта для отображения на карте, строка (обязательное поле)

    • city — город, строка (обязательное поле)

    • address — адрес, строка (обязательное поле)

    • title — название, строка (обязательное поле)

Last updated