Geocode address
The robot turns a free-form address into coordinates and a normalised address via the DaData service inside Bitrix24 business processes and robots. It accepts an address string in any format and returns latitude, longitude, the canonical address, postal code, region, city, timezone, coordinate precision and a found flag for the next workflow steps.
The robot sends an address string to the DaData cleaning service and returns geocoding results: latitude and longitude, a normalised canonical address, postal code, region, city or settlement, timezone and a text precision grade from exact coordinates down to coordinates undetermined. The found flag is Y only when actual coordinates were returned. Typical cases: preparing a delivery address from a deal for logistics and distance-to-warehouse calculations, and normalising lead addresses to a single format before segmenting by region. A configured DaData token is required. The outputs are available in the workflow designer: write them to deal or contact fields and use them in conditions of the next steps.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Address (any format) | string | yes |
What does the robot return?
| Parameter | Type |
|---|---|
| Latitude | string |
| Longitude | string |
| Normalised address | string |
| Postal code | string |
| Region | string |
| City | string |
| Timezone | string |
| Coordinate precision | string |
| Coordinates obtained (Y/N) | string |
Scenario: delivery coordinates from a deal address
- A deal moves to the Delivery stage
- The robot geocodes the client address via DaData
- Latitude, longitude and the normalised address are written to deal fields
- The logistics team gets the delivery point and the client timezone