---
url: https://gudhub.com/docs/core-api/filter/distance/
title: "Distance\n                #"
description: "This is the unique search type in the filter. Distance is used only in the GPS Coords item. It works with coordinates. Distance accepts two values: Place Radius"
lang: uk
updated: 2026-09-11T14:13:15.152Z
---

# Distance [#](https://gudhub.com/docs/core-api/filter/distance/#distance)

This is the unique search type in the filter. Distance is used only in the GPS Coords item. It works with coordinates. Distance accepts two values:

-   Place
-   Radius of searching

In filters list we can see:

Copy

```json
{
  "data_type": "gps_coords",
  "field_id": 625329,
  "search_type": "distance",
  "selected_search_option_variable": "Value",
  "valuesArray": [""]
}
```

Numbers in the following table means search radius in kilometers.

| F\\S | Kyiv, 20 | Lviv, 150 | Zaporizhzha, 2500 | Synevir, 500 | Askania-Nova, 2000 |
| :-- | :-: | :-: | :-: | :-: | :-: |
| Kyiv | + | \- | + | \- | + |
| Lviv | \- | + | + | + | + |
| Zaporizhzha | \- | \- | + | \- | + |
| TokySyneviro | \- | + | + | + | + |
| Askania-Nova | + | \- | + | \- | + |

> S - search values
> 
> Kyiv - type place
> 
> 20 - radius in kilometers
> 
> F - column of field values
> 
> "+" - matched by filter
> 
> "-" - not matched by filter

## Place [#](https://gudhub.com/docs/core-api/filter/distance/#place)

This argument accepts a name of the place in the text format. Counties, cities, streets and other objects one the map can be the value. Also, it allows to choose user current location.

## Radius of Searching [#](https://gudhub.com/docs/core-api/filter/distance/#radius-of-searching)

It accepts the radius of searching around the chosen place. It is calculated in kilometers.

## Examples [#](https://gudhub.com/docs/core-api/filter/distance/#examples)

The table of locations is looks like this:

Copy

```json
[{
  "item_id": 2979065,
  "fields": [{
      "field_id": 629160,
      "field_value": "42.3600825:-71.0588801"
  }]
  },
  {
  "item_id": 2979066,
  "fields": [{
      "field_id": 629160,
      "field_value": "40.7127753:-74.0059728"
    }]
  },
  {
  "item_id": 2979067,
  "fields": [{
      "field_id": 629160,
      "field_value": "51.5072178:-0.1275862"
  }]
  },
  {
  "item_id": 2979068,
  "fields": [{
      "field_id": 629160,
      "field_value": "35.6803997:139.7690174"
    }]
  },
  {
  "item_id": 2979069,
  "fields": [{
      "field_id": 629160,
      "field_value": "37.7749295:-122.4194155"
    }]
}]
```

Results of filtering:

-   Location: _San Francisco_
    
    Distance radius: _4000_
    
    Copy
    
    ```json
    [{
      "item_id": 2979069,
      "fields": [{
          "field_id": 629160,
          "field_value": "37.7749295:-122.4194155"
        }]
    }]
    ```
    
-   Location: _New York_
    
    Distance radius: _500_
    
    Copy
    
    ```json
    [{
      "item_id": 2979065,
      "fields": [{
          "field_id": 629160,
          "field_value": "42.3600825:-71.0588801"
      }]
      },
      {
      "item_id": 2979066,
      "fields": [{
          "field_id": 629160,
          "field_value": "40.7127753:-74.0059728"
        }]
    }]
    ```
    
-   Location: _London_
    
    Distance radius: _0_
    
    Copy
    
    ```json
    [{
      "item_id": 2979067,
      "fields": [{
          "field_id": 629160,
          "field_value": "51.5072178:-0.1275862"
      }]
    }]
    ```
    
-   Location: _Tokyo_
    
    Distance radius: _24000_
    
    Copy
    
    ```json
    [{
      "item_id": 2979065,
      "fields": [{
          "field_id": 629160,
          "field_value": "42.3600825:-71.0588801"
      }]
      },
      {
      "item_id": 2979066,
      "fields": [{
          "field_id": 629160,
          "field_value": "40.7127753:-74.0059728"
        }]
      },
      {
      "item_id": 2979067,
      "fields": [{
          "field_id": 629160,
          "field_value": "51.5072178:-0.1275862"
      }]
      },
      {
      "item_id": 2979068,
      "fields": [{
          "field_id": 629160,
          "field_value": "35.6803997:139.7690174"
        }]
      },
      {
      "item_id": 2979069,
      "fields": [{
          "field_id": 629160,
          "field_value": "37.7749295:-122.4194155"
      }]
    }]
    ```
    
-   Location: _Denver_
    
    Distance radius: _2000_
    
    Copy
    
    ```json
    [{
      "item_id": 2979069,
      "fields": [{
          "field_id": 629160,
          "field_value": "37.7749295:-122.4194155"
      }]
    }]
    ```