---
title: "fuzz geo locations · RUAL Documentation"
description: "For each item in the array, replaces the location with a uniformly-random point within a disc of the item's fuzzing distance (km) when the item's fuzzin…"
canonical: https://docs.rual.nl/block-types/array/array_fuzz_geo_locations
language: en
---

# fuzz geo locations

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

For each item in the array, replaces the location with a uniformly-random point within a disc of the item's fuzzing distance (km) when the item's fuzzing-enabled field is true. Items where fuzzing is disabled, the location is invalid, or the distance is non-positive pass through unchanged.

- Array required `array` Array of objects to fuzz.

- Location key required `value` The field path in each object that holds the geo point (e.g. location.location). Expects { lat, lon }.

- Fuzzing enabled key required `value` The field path in each object that holds the boolean toggle for fuzzing (e.g. fuzzing_enabled).

- Fuzzing distance key required `value` The field path in each object that holds the fuzzing radius in kilometers (e.g. fuzzing_distance).

- Fuzzing radius `condition` When true, the location is plotted exactly on the circle at the fuzzing distance (not within it) and the angle is derived deterministically from the original location, so repeated requests keep each item at roughly the same fuzzed point instead of jumping around.

- Array `array` Array with locations fuzzed per item.

For each object item whose fuzzing-enabled field is strict boolean true, replaces the point at location_key with a random point within a disc of the item's fuzzing-distance field (km). With fuzzing_radius true the point sits exactly ON the circle at a deterministic angle, so the same input always fuzzes the same way. Items with fuzzing disabled, a non-positive distance, or no valid lat/lon pass through UNCHANGED, as does the whole array when any key pin is empty.

| `geo` |
| --- |
| `fuzz` |
| `obfuscate` |
| `privacy` |
| `jitter` |
| `randomize location` |

A typical wiring for [fuzz geo locations](https://docs.rual.nl/block-types/array/array_fuzz_geo_locations): [with values](https://docs.rual.nl/block-types/array/array_of_values) feeds the `array` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `location_key` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `fuzzing_enabled_key` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `fuzzing_distance_key` pin; the `array` out pin feeds [length](https://docs.rual.nl/block-types/array/array_length).

![Studio canvas example for the fuzz geo locations block: typical wiring for fuzz geo locations.](https://docs.rual.nl/canvas-examples/array_fuzz_geo_locations.png)

### Version history

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