Skip to Content
GeocodingHow-to guidesOrigin or Destination as an address or Plus Code

Write the Origin or Destination as an address or Plus Code

For: implementers.

A feed may send no originSite or destinationSite: only the text of the Origin or Destination cell (origin, destination). If that text is not a geofence code, the platform reads it as an address or a Plus Code, with the feed’s country.

The feed’s country

Each feed has an optional two-letter country (ISO 3166-1 alpha-2). Set it in Settings › Trips › Feeds, when you create or edit the feed, in the Country field. Through the API, it is the feed’s country field.

How the cell is read

The cell is read only if the service sends no site for that place and the location with that code has no geofence.

Cell textRead asCountry
A full Plus Code: 47RFH86X+VRplusCodeThe feed’s, if it has one
A short Plus Code: H86X+VRplusCodeThe feed’s. If the feed has no country, the cell is ignored
Text with spaces, letters and digits: Av. Jorge Alessandri 10700, San BernardoaddressThe feed’s. If the feed has no country, the cell is ignored
Anything else: SCL, CD-NORTE-1Nothing: it is only a code

A site the feed sends (originSite, destinationSite) wins over the cell. The retry rules are the same: a location that is resolved, rejected or has a geofence is not tried again.

The feed job’s result lists the cell like any other site: "located": ["Av. Jorge Alessandri 10700, San Bernardo: resolved"].

What resolves and what does not

The cell has no district. The result depends on that:

CellChilePeru
Address with the district after the number: Camino Lo Boza 120, PudahuelResolves: the district comes from the textResolves if the named district is unique in the country
Address without a district: Jorge Alessandri 10700The number is looked up in the internal addresses of the whole country. If the street matches, the district is that address’sNeeds review
Full or short Plus CodeNeeds review, with no declared district (district is required, or a short plus code needs a district with a boundary)Same

Pitfall: today a Plus Code in the cell always needs review, because the platform requires a declared district. To locate by Plus Code from a spreadsheet, send the district in originSite / destinationSite, or use the Plus Code column with its district (Send sites from a feed).

Spreadsheet recommendations

RuleExample
If the place has a geofence, write its codeSCL
If not, write street, number and district, separated by commasCamino Lo Boza 120, Pudahuel
Do not mix the place name and the address in the cellBodega Norte - Camino Lo Boza 120 does not read well
Always the same text for the same placeThe text is the location’s code: different text is a different location
Last updated on