Addresses

An address is sent structured into fields, and always includes coordinates. Govza does not geocode.

Address fields

Field	Required	Notes
latitude	yes	−90 to 90.
longitude	yes	−180 to 180.
area	yes	City or locality.
street	yes	Street name, without the house number.
building	yes	House number, as text — "12к3" is valid.
apartment	no	Whole number.
entrance	no	Whole number.
floor	no	Whole number.
intercom	no	Door entry code.
instructions	no	Free text for the courier.

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

Coordinates and the service area

Coordinates determine the route and the price.

If none of the order’s points is inside the service area, the order is rejected at creation. Check points in advance with POST /availability.

Apartment, entrance and floor

These fields accept whole numbers only. A value such as "12A" is rejected:

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

Put anything that does not fit a number into instructions, which the courier sees:

{
  "apartment": 12,
  "instructions": "Block A, entrance from the courtyard"
}

Contacts

The pickup and every dropoff carry a contact with a phone number:

{ "value": "+79280003396", "name": "Musa" }

Phone numbers are normalised on our side, so the formatting of the value does not matter. name is optional but helps the courier.