---
title: "geocoding · RUAL Documentation"
description: "Uses the Geocoding API to obtain geocoding data for one or more addresses or places"
canonical: https://docs.rual.nl/block-types/google/google_places_geocoding
language: en
---

# geocoding

This block is part of the [`google`](https://docs.rual.nl/block-types/google) group and was last modified in core [`v13.0.4`](https://docs.rual.nl/core-versions/130004).

Uses the Geocoding API to obtain geocoding data for one or more addresses or places

- flow `flow`

- Api key required `value` Your application's API key, created within your Google Cloud Platform Console.

- address required `value` The address of the place you want to use for the geocoding.

- language `value` The language in which to return results.

- flow `flow`

- success `condition` Returns true if requests succeeded.

- results `array` Result of the geocoding

- error `value` The response error code (API Request).

| `places` |
| --- |

A typical wiring for [geocoding](https://docs.rual.nl/block-types/google/google_places_geocoding): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `api_key` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `address` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

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

### Version history

Introduced in [`v13.0.4`](https://docs.rual.nl/core-versions/130004).

### Service documentation