Feature Property

A feature property is every piece of data you specify for your feature.

  • In a Google Sheet, each column that is not one of the reserved ones for features (title, country, region and city for Geographic Area, and title, type and coordinates for Geographic Location) represents a feature property.

For example:

  • In apps of subtype Geographic Area, your feature can have properties fill_color, risk_rating, population, majority_age, etc, that represent a piece of data for your country, state/region or city.

  • In apps of subtype Geographic Location, your feature can have properties phone, address, contact_email, capacity, etc, that represent some metadata for your desired feature type.

A feature property belongs to a feature. A feature can have many feature properties.

Fields

A feature property has a name, a value and a dataType.

FieldDescriptionExample

name

The name of your feature property.

office_address

dataType

The data type of the value of your feature property, to be converted later in our end.

STRING, INT, JSON, DECIMAL, BOOLEAN or DATE

value

The value of your feature property.

Some string, 2, {"sample":"json"}, 2.13, true, 2023-12-01T12:00:00Z

Reserved Names

Custom Style: Color

NameDescriptionValidationDefault valueExample

fill_color

Fill color of your polygons/markers.

Valid hexadecimal colors (see Color codes).

#000000

#FF0000

line_color

Stroke color of your polygons/markers.

Valid hexadecimal colors (see Color codes).

#CCCCCC

#000000

Custom Style: Shape

NameDescriptionValidationDefault valueExample

circle_radius

Radius of the circle (only apps of subtype PLACE_DATA_GEOGRAPHIC_LOCATION), in pixels.

An integer between 1 and 30.

7

5

circle_border_width

Border width of the circle (only apps of subtype PLACE_DATA_GEOGRAPHIC_LOCATION), in pixels.

An integer between 1 and 30.

4

2

Custom Style: Legend

NameDescriptionValidationDefault valueExample

legend_title

Title of the legends to be displayed on the map.

None.

None.

Small capacity

legend_description

Description of the legends.

None.

None.

From 1 to 30 people

photos

An array of picture URLs to display in the legend.

Valid array of strings.

None.

["https:example.com/some-image.jpg"]

Hotel Data

NameRequiredDescriptionValidationExample

country_name

Either country (feature) or country_name.

The country name, in case you haven't specified the ISO code in field country from the feature.

Non-empty string values.

Netherlands

bcom_id

Either address (feature) or bcom_id.

The ID of the hotel in Booking.com. We will use it to fetch the hotel details from the Booking.com API, such as the chain name, the stars, the number of rooms, the link or the thumbnail. If you specify address instead, we will fetch the coordinates of the hotel using a geolocation provider to represent it on the map. Using the Booking.com ID is more accurate than geolocating the hotel by address. Use the following script to get the hotel ID from the hotel page on Booking.com: +document.querySelector('input[name="hotel_id"]').value

Valid integer.

171124

city_name

true

City name.

Non-empty string values.

Amsterdam

green_score

true

The green score of the hotel.

Valid integer.

81

green_score_icon

false

Any icon you want to display in the hotel card, in SVG format.

Valid SVG object.

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 125 80"><text y="75" font-size="100" font-family="serif"><![CDATA[81]]></text></svg>

Examples

In apps of subtype Geographic Area:

In apps of subtype Geographic Location:

Pictures in the legend, defined in feature property with name photos:

In the hotel card:

Color Codes

We support hexadecimal color codes to customize the map. Hexadecimal color codes can be picked from a design software or an online tool like the Colour Picker from Google.

Last updated