geo_point_to_h3cell()

Calculates the H3 Cell token string value of a geographic location.

Read more about H3 Cell.

Syntax

geo_point_to_h3cell(longitude, latitude, [ resolution ])

Parameters

Returns

The H3 Cell token string value of a given geographic location. If the coordinates or levels are invalid, the query will produce an empty result.

H3 Cell approximate area coverage per resolution value

The table source can be found in this H3 Cell statistical resource.

See also geo_point_to_s2cell(), geo_point_to_geohash().

Examples

print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)

Output

The following example finds groups of coordinates. Every pair of coordinates in the group resides in the H3 Cell with average hexagon area of 253 km².

datatable(location_id:string, longitude:real, latitude:real)
[
    "A", -73.956683, 40.807907,
    "B", -73.916869, 40.818314,
    "C", -73.989148, 40.743273,
]
| summarize count = count(),                                         // Items per group count
            locations = make_list(location_id)                       // Items in the group
            by h3cell = geo_point_to_h3cell(longitude, latitude, 5)  // H3 Cell of the group

Output

The following example produces an empty result because of the invalid coordinate input.

print h3cell = geo_point_to_h3cell(300,1,8)

Output

The following example produces an empty result because of the invalid level input.

print h3cell = geo_point_to_h3cell(1,1,16)

Output

The following example produces an empty result because of the invalid level input.

print h3cell = geo_point_to_h3cell(1,1,int(null))

Output