---
url: https://gudhub.com/docs/gh-elements/gps-coords/
title: "GPS Coords\n                #"
description: "GPS Coords is a gh element that allows the user to find and save any location on the map. It is most often used in combination with Google Map. This is because"
lang: uk
updated: 2026-09-08T15:52:47.730Z
---

# GPS Coords [#](https://gudhub.com/docs/gh-elements/gps-coords/#gps-coords)

**GPS Coords** is a gh-element that allows the user to find and save any location on the map. It is most often used in combination with [Google Map](https://gudhub.com/docs/gh-elements/google-map/). This is because the location of an item on _Google Maps_ is determined by the [value](#value-format) of the current element.

![Using GPS coordinates](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-work.gif "GPS coords")

So, this element determines the coordinates of the location entered by user. The user can enter both the name or address of the location and the coordinates themselves. In the first case, the GPS Coords determine the coordinates by the entered name or address.

The selected location will be displayed as a mark on the mini-map. Thus, it can also be used as a full-fledged map with a single mark. But this is not allowed for all [types of interpretation](#interpretation).

## Functional Characteristics [#](https://gudhub.com/docs/gh-elements/gps-coords/#functional-characteristics)

As was mentioned above, the current gh-element is mostly used in pair with the [Google Map](https://gudhub.com/docs/gh-elements/google-map/). But actually, it allows you to configure the **Google Map**, namely, determines the location of items on the map. That allows you to track user's location or location of some places. In practice, it has been used for realtor applications, tourist maps, or GPS applications.

You can also update the **GPS coordinates** by connecting them to the [Text](https://gudhub.com/docs/gh-elements/text/) or [Number](https://gudhub.com/docs/gh-elements/number/) elements, for example. You can do this in [Address Transfer Settings](#address-transfer-settings). This allows you to make the location available for input from the appropriate fields.

## Element Options [#](https://gudhub.com/docs/gh-elements/gps-coords/#element-options)

The **GPS Coords** has many different options that allow you to customize its operation.

### Field Settings [#](https://gudhub.com/docs/gh-elements/gps-coords/#field-settings)

The GPS coords have a set of general options that allows to customize it.

![Field settings of GPS coords element](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-field-settings.jpg "GPS coords field settings")

Field settings contains standard properties Field Name and Name Space, and its unique ones.

| Name | Description |
| :-- | :-- |
| Units system for filter | allows to choose units that will be used during filtering; [details...](#units-system-for-filter) |
| Open map on dblclick | allows you to customize the opening of the map after a double click; [details...](#open-map-on-dblclick) |
| Confirm modal popup | allows you to use a pop-up window when you change coordinates; [details...](#confirm-modal-popup) |
| Use current location | allows you to take the coordinates of the current location of the user; [details...](#use-current-location) |
| Reload location time, ms | allows you to configure at wha interval the location will be updated; appears if Use current location is on; [details...](#reload-location-time-ms) |
| Zoom | allows to customize map zoom; [details...](#zoom) |
| Map style | allows to customize map style; [details...](#map-style) |

#### **Units System For Filter** [#](https://gudhub.com/docs/gh-elements/gps-coords/#units-system-for-filter)

Due to this setting you can set the unit system which is used for filtering. This means that when you use [filters associated with the current element](#filtration), you can only enter filter values in the system of the selected units. There are two systems of blocks available:

-   **Metric**
-   **Imperial** The area and distance will be calculated in different units depending on the mode selected.

#### **Open Map On Dblclick** [#](https://gudhub.com/docs/gh-elements/gps-coords/#open-map-on-dblclick)

With the current setting, you can determine how the map will respond to a double click. That is, if the current setting is enabled, the location saved in the element will be opened in Google Maps in a new tab.

Due to this setting, the user can examine the location in more detail. If this option is disabled, the map will zoom in relative to the clicked location after each double-click.

#### **Confirm Modal Popup** [#](https://gudhub.com/docs/gh-elements/gps-coords/#confirm-modal-popup)

In **GPS coordinates** there is a setting to confirm the data update. Namely, it allows you to enable a confirmation pop-up window. This means that every time the user updates their location, a confirmation window will appear. And to save the new location, the user must click the corresponding button.

![Using the confirm pop-up](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-comfirm-modal-popup.gif "Comfirm modal popup")

Accordingly, if this function is disabled, the user can even accidentally change the value. And the current setting will ensure that the data is saved.

#### **Use Current Location** [#](https://gudhub.com/docs/gh-elements/gps-coords/#use-current-location)

The current settings allow **GPS Coords** to track the user's location. If this feature is enabled, the item will automatically save the user's current location and the user will not be able to enter any other location. It is used in combination with the following setting to track the user's location in real time.

> This feature will only work if the **user allows their location to be tracked** in the browser.

#### **Reload Location Time, ms** [#](https://gudhub.com/docs/gh-elements/gps-coords/#reload-location-time-ms)

This setting allows you to set the time when the user's location data is reloaded. This allows the user to track their location in real time. The value must be entered in milliseconds.

> This option is available only if the [Use Current Location](#use-current-location) option is enabled.

That is, due to this function, at every specified interval, the value of the current field will be overwritten. Use this setting to implement the navigation function in your app.

#### **Zoom** [#](https://gudhub.com/docs/gh-elements/gps-coords/#zoom)

This setting allows you to adjust the map zoom around the saved coordinates. You can do this with the range bar or the input box next to it. Depending on the selected value the map of the **GPS Coords** will display the different map sizes.

#### **Map Style** [#](https://gudhub.com/docs/gh-elements/gps-coords/#map-style)

Using this setting you can customize the map appearance. It offers a list of three styles. Each of them has its unique appearance.

-   **Standard** - classic map appearance.
-   **Retro** - displays map in light pastel colors.
-   **Night** - map displayed in dark blue colors. ![using the map styles](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-map-style.gif "Map style")

Since the **GPS Coords** mini map is very similar to a [Google Map](https://gudhub.com/docs/gh-elements/google-map/), the map styles work the same way.

> The styles are applied only for the **Map mode** of displaying.

In addition, there are a limited number of [types of interpretation](#interpretation) that the current setting works with.

### Address Transfer Settings [#](https://gudhub.com/docs/gh-elements/gps-coords/#address-transfer-settings)

These are parameters that allow you to configure where various location data will be stored and where the location coordinates will be taken from.

![Address transfer settings of GPS coords](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-address-transfer-settings.jpg "Address transfer settings")

| Name | Description |
| :-- | :-- |
| Address | allows to configure which data will be stored in the selected field; [details...](#address) |
| Short name | allows to save short names instead of full ones; [details...](#short-name) |
| Required | allows to configure whether the field will be mandatory for changing coordinates or not; [details...](#required) |
| Field | allows to choose the field from which the data for coordinates will be taken; [details...](#field) |
| Edit | allows to update or delete option; [details...](#edit) |

#### **Address** [#](https://gudhub.com/docs/gh-elements/gps-coords/#address)

The current setting is the first in the block responsible for saving the address from **GPS Coords**. Since the current element stores GPS coordinates as a value, you must choose which part of the address will be passed to another field.

So, the current setting consists of a list of address components available for transfer. This allows you to store and display various information about the selected location in the current item and also search locations by entering the selected **address component** in the [related field](#field). That is, it determines which part of the address the user can enter into a certain field to find the desired location, and which part will be saved in the field. There are all existing components:

| Address | address\_component | Value |
| :-- | :-- | :-- |
| City | `"locality"` | name of the city |
| Street | `"route"` | name of the street |
| Neighborhood | `"neighborhood"` | name of the neighborhood |
| Apartment Number | `"subpremise"` | number of the apartment |
| Street Number | `"street_number"` | number of the street |
| County | `"administrative_area_level_2"` | name of the county |
| State | `"administrative_area_level_1"` | name of the state |
| Country | `"country"` | name of the country |
| Postal Code | `"postal_code"` | ZIP code |
| Full Address | `"formatted_address"` | full address |
| Address | `"address"` | address |
| Place ID | `"place_id"` | ID of the place |

When the user enters any location in **GPS Coords**, the **selected component** will be taken from its address and saved in the [related field](#field).

> Note that any of these components will be saved only if it **exists for the current location and is sufficiently detailed**.

That is, if the **user simply enters "New York"**, the fields with an **address or neighborhood will not be filled in**. It is even possible that the location of the wrong city will be selected.

#### **Short Name** [#](https://gudhub.com/docs/gh-elements/gps-coords/#short-name)

Many geographic entities, such as countries and cities, have short versions of their names. To store short names of [certain components](#address) in the [corresponding field](#field), you can use this switch. So, when this feature is enabled, short versions of the names will be saved to the attached fields.

> But only if the short name of this location and, accordingly, this [address component](#address) exists at all.

![Using short name setting](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-short-name.gif "Short name")

The same works in the opposite direction. Namely, this setting allows the user to enter a short name for the location search. And also the entered full name will be rewritten to a short one.

#### **Required** [#](https://gudhub.com/docs/gh-elements/gps-coords/#required)

In brief, this setting makes the corresponding field mandatory for location search. This means that the user must enter a value in this field, otherwise the location will not be found. So, this setting is intended to find locations from [related field](#field), not directly in the element.

#### **Field** [#](https://gudhub.com/docs/gh-elements/gps-coords/#field)

The next important setting is the field associated with the current gh-element. This setting allows you to select the field that will be connected to the current option. Then the [component](#address) of the location entered in the **GPS Coords** will be saved here. And the value entered in this field will be used to find the location.

![Using field to set the location](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-search-by-field.gif "Searching location by the field value")

For example, imagine that you have configured the address transfer option as a `City` component with an associated field called **Selected City**. Then the user enters **London** into this field. As a result, the **GPS Coords** element will **find the coordinates of the city of London and save them**. Accordingly, the location with a marker will be shown on the mini-map.

![Using field to display the address component](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-store-location-in-field.gif "Saving location in the field")

In case you transfer an address from GPS coordinates to a field with the same settings, the situation will be almost the same. When the user enters a location directly into **GPS coordinates**, this element will determine which city the coordinates refer to and save the city of London in the **Selected city** field.

#### **Edit** [#](https://gudhub.com/docs/gh-elements/gps-coords/#edit)

The last setting in this block allows you to configure only the current option. That is, this setting is unique for each option, as well as all previous settings in the **Address Transfer Settings**. So, this **Edit** block contains two buttons that are responsible for editing and deleting an option. That is, when you click on the button with a pencil, the option becomes available for editing. And when you click on the button with a trash can, the option will be deleted.

## Element Style [#](https://gudhub.com/docs/gh-elements/gps-coords/#element-style)

Element style of GPS coords has all general settings about which you can read in [Setting Overview](https://gudhub.com/docs/understanding-gudhub/gh-elements-structure/setting-overview/). The other case is a variety of interpretations about that you can read [below](#interpretation).

![Element style of GPS coords](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-element-style.jpg "GPS coords element style")

## Filtration [#](https://gudhub.com/docs/gh-elements/gps-coords/#filtration)

There are only two filters which can filter out gps coords:

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

## Interpretation [#](https://gudhub.com/docs/gh-elements/gps-coords/#interpretation)

GPS Coords has many interpretation types. Most of them are related to map displaying.

![Interpretation types of GPS coords](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/gps-coords-interpretation-types.jpg "GPS coords interpretation types")

### Default [#](https://gudhub.com/docs/gh-elements/gps-coords/#default)

Default interpretation for GPS coords is an icon. It is uneditable.

### Coords [#](https://gudhub.com/docs/gh-elements/gps-coords/#coords)

This interpretation type allows to enter address in the format of geographic coordinates and edit them.

### Coords Input [#](https://gudhub.com/docs/gh-elements/gps-coords/#coords-input)

This interpretation allows to enter, edit, and display address in the text format.

### Map [#](https://gudhub.com/docs/gh-elements/gps-coords/#map)

This is an interactive interpretation type. It allows to enter address and shows that place on the map immediately.

### Size 256x256 [#](https://gudhub.com/docs/gh-elements/gps-coords/#size-256x256)

This is one of map interpretation. It has fixed size 256x256.

### Size 512x512 [#](https://gudhub.com/docs/gh-elements/gps-coords/#size-512x512)

This is an interpretation of a fixed-size map. The size is 512x512.

### Size Auto [#](https://gudhub.com/docs/gh-elements/gps-coords/#size-auto)

This is one interpretation of the map that flexibly adjusts to the size of the browser window.

## Value Format [#](https://gudhub.com/docs/gh-elements/gps-coords/#value-format)

As mentioned above, GPS coors value is geographical coordinates that are contained as a string.

Copy

```json
{
    "field_value": "40.7127753:-74.0059728"
}
```

First number is latitude, the second one is longitude. They are separated by a colon.

In most of interpretation types, you can enter an address in text format. Then it will be converted in coordinates.

## Data Model [#](https://gudhub.com/docs/gh-elements/gps-coords/#data-model)

GPS coords has quite complex data model.

Copy

```json
{
    "data_model": {
        "interpretation": [],
        "map_style": "night",
        "modal": 1,
        "open_map": 0,
        "options": [{
            "address_component": "locality",
            "field_id": "638831",
            "required": 1,
            "short_name": 1
        }],
        "regExpDistance": "^\\d+(.d+)?$",
        "regular_expression_lat": "^-?([1-8]?\\d(\\.\\d+)?|90(\\.0+)?)$",
        "regular_expression_lon": "^-?(180(\\.0+)?|((1[0-7]\\d)|([1-9]?\\d))(\\.\\d+)?)$",
        "useCurrentLocation": 0,
        "reloadLocationTime": "124556567567",
        "units": "metric",
        "zoom": "13"
    }
}
```

It contains all data about the element and its options.

| Name | Type | Description |
| :-- | :-- | :-- |
| interpretation | `array` | _contains all gps coords interpretations_ |
| map\_style | `string` | _contains a style of map_ |
| modal | `boolean` | _shows whether the pop-up window will appear when user changes coordinates_ |
| open\_map | `boolean` | _shows whether the map will open after double click_ |
| options | `array` | _object array of gps coords options_ |
| address\_component | `string` | _contains the type of field address; [details...](#address)_ |
| field\_id | `string` | _ID of field from that the address is taken_ |
| required | `boolean` | _shows whether field is mandatory to be filled_ |
| short\_name | `boolean` | _shows whether will be displayed full value name or short_ |
| regExpDistance | `string` | _regular expression that checks format of the distance value_ |
| regular\_expression\_lat | `string` | _contains regular expression that checks whether latitude has a right format_ |
| regular\_expression\_lon | `string` | _contains regular expression that checks whether longitude has a right format_ |
| useCurrentLocation | `boolean` | _shows whether the coordinates of the user's current location will be used_ |
| reloadLocationTime | `string` | _contains time between location updating_ |
| units | `string` | _contains a type of units systems for filters_ |
| zoom | `string` | _contains a value of a zoom_ |