GPS Coords

GPS Coords is an element that constitutes geographical coordinates in a string. Due to it you can use maps in you application.

It is a quite difficult gh-element. Mostly because of its options that will talk about in this chapter.

Functional Characteristics

GPS coordinates are used in google map to locate the item on the map. It can also use text items to determine location coordinates.

Value Format

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

{
    "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.

Element Options

GPS coords has lots of different options but does not have default values.

Field Settings

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

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

Units system for filter

Due to this function you can configure the unit system which is used for filtering. This means that area and distance will be calculated in different units depending on the mode selected.There are two only types of systems:

• Metric
• Imperial

Open map on dnlclick

With this option, you can set your map to open in a new browser window when you double-click it in the app.

Confirm modal popup

With this option, every time the user tries to change the location, a pop-up window will ask if the user is sure.

Use current location

This option allows the gps coords use users current location. It also opens one more option called Reload location time, ms.

Reload location time, ms

Use this option to set the time interval at which the user's current location will be updated. It is useful, when you are on the move and need to track your location.

Zoom

This option allow you to configure the map zoom. The minimum zoom is 1 and the maximum is 23.

Map style

Due to this option you can set the style of the map displaying in the application. There are three possible styles:

• Standard
• Retro
• Night

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 Values

GH-elements have many different option. But we would like to draw your attention to Address in Address Transfer Settings. It has a list of value types that determine what data will be stored in it.

Address is a field in which the certain data from map will be saved, even if the field with such name does not exist in application. If such field exists, the value will be saved and displayed in it.

In following table you can find all Address value types and their corresponding values of address_component.

Short name

Many geographical objects have short variants of their names, and this option allows you to find the place by its short name in the field instead of the full name.

Required

This option makes the field value mandatory when searching for a place. That is, without this value, the map will not update, even if there are more fields with the address.

Field

Here you can set from which field the address will be taken for the search.

Edit

In this setting we have two buttons that allows to edit or delete the address option.

Element Style

Element style of GPS coords has all general settings about which you can read in Setting Overview. The other case is a variety of interpretations about that you can read below.

Data Model

GPS coords has quite complex data model.

{
    "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.

Filtration

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

• Place
• Current location

Interpretation

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

Default

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

Coords

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

Coords Input

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

Map

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

Size 256x256

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

Size 512x512

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

Size Auto

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