Адреса

Адрес передаётся разобранным на поля и обязательно с координатами. Govza не занимается геокодированием.

Поля адреса

Поле	Обязательное	Примечание
latitude	да	От −90 до 90.
longitude	да	От −180 до 180.
area	да	Город или населённый пункт.
street	да	Название улицы, без номера дома.
building	да	Номер дома в виде строки, например "12к3".
apartment	нет	Целое число.
entrance	нет	Целое число.
floor	нет	Целое число.
intercom	нет	Код домофона.
instructions	нет	Свободный текст для курьера.

{
  "latitude": 43.3200,
  "longitude": 45.7000,
  "area": "Грозный",
  "street": "улица Мира",
  "building": "12",
  "apartment": 4,
  "entrance": 2,
  "floor": 3,
  "intercom": "12К4590",
  "instructions": "Вход со двора"
}

Координаты и зона обслуживания

Координаты определяют маршрут и стоимость.

Если ни одна точка заказа не входит в зону обслуживания, заказ отклоняется при создании. Проверить точки заранее можно через POST /availability.

Квартира, подъезд и этаж

Эти поля принимают только целые числа. Значение вроде "12А" будет отклонено:

{
  "field": "dropoffs.0.address.apartment",
  "message": "must be a whole number; put anything else in address.instructions"
}

Всё, что нельзя записать целым числом, укажите в instructions — этот текст видит курьер:

{
  "apartment": 12,
  "instructions": "Литера А, вход со двора"
}

Контакты

У точки забора и у каждой точки доставки должен быть контакт с телефоном:

{ "value": "+79280003396", "name": "Муса" }

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