Адреса

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

Поля адреса

Поле	Обязательное	Примечание
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": "Вход со двора"
}

Координаты и текст

Координаты определяют маршрут и стоимость. Текстовые поля — это то, что курьер читает по дороге. Между собой они не сверяются, поэтому следите, чтобы они описывали одно и то же место.

Если координаты попадают за пределы зоны обслуживания, заказ отклоняется при создании.

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

Эти поля принимают только целые числа. Значение вроде "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 необязателен, но помогает курьеру.