---
title: "from city · RUAL Documentation"
description: "Resolves a city/town name (optionally constrained to a country code, e.g. NL, and a province/state, e.g. Vermont) to a geo point at the city centre, plu…"
canonical: https://docs.rual.nl/block-types/geopoint/geo_point_from_city
language: en
---

# from city

This block is part of the [`geopoint`](https://docs.rual.nl/block-types/geopoint) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Resolves a city/town name (optionally constrained to a country code, e.g. NL, and a province/state, e.g. Vermont) to a geo point at the city centre, plus the city's radius in metres and its province/country. Offline lookup against the embedded dataset. A city name is not unique within a country : eight US states have a Morristown : so wire `province` whenever you know it, for example straight from `geo point reverse geocode`.

- city required `value` city/town name to look up, e.g. Brummen

- country code `value` optional ISO country code to disambiguate, e.g. NL. Leave empty to search all covered countries.

- province `v15.0.0` `value` optional province/state to disambiguate, e.g. Vermont. Leave empty to search the whole country. When set it must match a place in that province, otherwise the lookup fails with NOT_FOUND rather than returning a same-named city elsewhere.

- geo point `geo_point` point at the city centre

- radius `number` approximate radius of the city in kilometres (population-derived)

- province `value`

- country `value`

- country code `value`

- success `condition`

- error `value` MISSING_CITY, NOT_FOUND or GEOCODER_NOT_AVAILABLE when success is `false`.

| `geocode` |
| --- |
| `city to coordinates` |
| `city center` |
| `forward geocode` |

A typical wiring for [from city](https://docs.rual.nl/block-types/geopoint/geo_point_from_city): [reverse geocode](https://docs.rual.nl/block-types/geopoint/geo_point_reverse_geocode) feeds the `city` pin; the `geo_point` out pin feeds [if](https://docs.rual.nl/block-types/geopoint/geo_point_branch); the `radius` out pin feeds [if](https://docs.rual.nl/block-types/number/number_branch).

![Studio canvas example for the from city block: typical wiring for from city.](https://docs.rual.nl/canvas-examples/geo_point_from_city.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [if](https://docs.rual.nl/block-types/geopoint/geo_point_branch): this block feeds into it.

- [reverse geocode](https://docs.rual.nl/block-types/geopoint/geo_point_reverse_geocode): feeds into this block. Resolves a geo point to the nearest street, city, province and country. City/province/country are nearest-populated-place, and always stay in the country of the nearest known place — a point near a border is never relabelled with a larger city on the other side. Street is the nearest named road (needs the road network loaded).

- [if](https://docs.rual.nl/block-types/number/number_branch): this block feeds into it.

### Used in these guides

These documentation pages use or explain this block:

- [Location Blocks](https://docs.rual.nl/reference/location-blocks)

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).