reverse geocode

This block is part of the array group and was last modified in core v15.0.0.

reverse geocode array v15.0.0

Enriches an array of objects in place: for each item it reads the geo point at the location key and writes the resolved city, province, country and country code into the configured output keys. Offline lookup (embedded multi-country dataset).

In pins 9

Array required
array
Array of objects, each holding a geo point at the location key.
Location key required
value
The field path in each object that holds the geo point (e.g. location.location). Expects { lat, lon }.
Location fallback key
value
Optional second field path on the same object, used when the primary location key has no valid { lat, lon }.
Street key
value
Output field path for the nearest named road. Empty when no road is within range or the road network is not loaded. Leave empty to skip.
Default street
City key
value
Output field path for the resolved city (e.g. city or address.city). Leave empty to skip.
Default city
Neighborhood key v15.0.0
value
Output field path for the wijk/district when the point sits inside a larger city (empty otherwise). Leave empty to skip.
Default neighborhood
Province key
value
Output field path for the resolved province. Leave empty to skip.
Default province
Country key
value
Output field path for the resolved country. Leave empty to skip.
Default country
Country code key
value
Output field path for the resolved ISO country code. Leave empty to skip.
Default country_code

Out pins 2

Array
array
The input array with each item enriched in place.
Unresolved
array
Items that had no valid location and could not be geocoded.

Enriches each object IN PLACE: reads { lat, lon } at location_key (falling back to location_fallback_key) and writes the resolved street, city, neighborhood, province, country and country code to each non-empty output key. The array pin always returns ALL items; items that are non-objects, lack valid coordinates or fail resolution are additionally listed on unresolved, appearing in BOTH outputs. With no location_key or no dataset loaded, the input passes through untouched.

geocode

city

province

country

geo

A typical wiring for reverse geocode: with values feeds the array pin; value feeds the location_key pin; the array out pin feeds length.

Studio canvas example for the reverse geocode block: typical wiring for reverse geocode.

Used in these guides

These documentation pages use or explain this block:

Location Blocks

Version history

Introduced in v15.0.0.

Back to array Return to the main group to view all sub-groups Back to array Return to the group to view all blocks within this group

Cluster

Blocks

Interfaces

Blueprints

Tutorials

Examples

Reference

Architecture

Troubleshooting

Other

reverse geocode

Used in these guides

Version history