---
title: "nearby search · RUAL Documentation"
description: "search within Google Places for nearby points of interest."
canonical: https://docs.rual.nl/block-types/google/google_places_nearby
language: en
---

# nearby search

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

search within Google Places for nearby points of interest.

- flow `flow`

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

- lat required `number` The latitude around which to retrieve place information.

- lon required `number` The longitude around which to retrieve place information.

- radius (m) required `number` Defines the distance (in meters) within which to return place results. The maximum allowed radius is 50 000 meters. • Max: 50000

- open now `condition` Only return places that are open now.

Default `false`

- type `value` Type of property to search e.g. accounting

Default `all`

- page token `value` The token from google to request the next page.

- rankby `value` Rank results by prominence (default) or distance.

Default `prominence`

- scroll pages `condition` Auto scroll trough all the available pages.

Default `false`

- flow `flow`

- success `condition` returns true if requests succeeded

- results `array` result of places without locality

- has_next_page `condition` if there is a next page with results

- route results `array` full results including locality

- page_token `value` next page token to proceed the request

- error `value`

| `places` |
| --- |

A typical wiring for [nearby search](https://docs.rual.nl/block-types/google/google_places_nearby): 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; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `latitude` pin; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `longitude` pin; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `radius` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

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

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).