SQL Extensions

HEAVY.AI implements a number of custom extension functions to SQL.

Rendering

The following table describes SQL extensions available for the HEAVY.AI implementation of Vega.

SQL SELECT

Function

Arguments and Return

convert_meters_to_merc_pixel_width(meters, lon, lat, min_lon, max_lon, img_width, min_width)

Converts a distance in meters in a longitudinal direction from a latitude/longitude coordinate to a pixel size using mercator projection:

  • meters: Distance in meters in a longitudinal direction to convert to pixel units.

  • lon: Longitude coordinate of the center point to size from.

  • lat: Latitude coordinate of the center point to size from.

  • min_lon: Minimum longitude coordinate of the mercator-projected view.

  • max_lon: Maximum longitude coordinate of the mercator-projected view.

  • img_width: The width in pixels of the view.

  • min_width: Clamps the returned pixel size to be at least this width.

Returns: Floating-point value in pixel units. Can be used for the width of a symbol or a point in Vega.

convert_meters_to_merc_pixel_height(meters, lon, lat, min_lat, max_lat, img_height, min_height)

Converts a distance in meters in a latitudinal direction from a latitude/longitude coordinate to a pixel size, using mercator projection:

  • meters: Distance in meters in a longitudinal direction to convert to pixel units.

  • lon: Longitude coordinate of the center point to size from.

  • lat: Latitude coordinate of the center point to size from.

  • min_lat: Minimum latitude coordinate of the mercator-projected view.

  • max_lat: Maximum latitude coordinate of the mercator-projected view.

  • img_height: The height in pixels of the view.

  • min_height: Clamps the returned pixel size to be at least this height.

Returns: Floating-point value in pixel units. Can be used for the height of a symbol or a point in Vega.

convert_meters_to_pixel_width(meters, pt, min_lon, max_lon, img_width, min_width)

Converts a distance in meters in a longitudinal direction from a latitude/longitude POINT to a pixel size. Supports only mercator-projected points.

  • meters: Distance in meters in a latitudinal direction to convert to pixel units.

  • pt: The center POINT to size from. The point must be defined in the EPSG:4326 spatial reference system.

  • min_lon: Minimum longitude coordinate of the mercator-projected view.

  • max_lon: Maximum longitude coordinate of the mercator-projected view.

  • img_width: The width in pixels of the view.

  • min_width: Clamps the returned pixel size to be at least this width.

Returns: Floating-point value in pixel units. Can be used for the width of a symbol or a point in Vega.

convert_meters_to_pixel_height(meters, pt, min_lat, max_lat, img_height, min_height)

Converts a distance in meters in a latitudinal direction from an EPSG:4326 POINT to a pixel size. Currently only supports mercator-projected points:

  • meters: Distance in meters in a longitudinal direction to convert to pixel units.

  • pt: The center POINT to size from. The point must be defined in the EPSG:4326 spatial reference system.

  • min_lat: Minimum latitude coordinate of the mercator-projected view.

  • max_lat: Maximum latitude coordinate of the mercator-projected view.

  • img_height: The height in pixels of the view.

  • min_height: Clamps the returned pixel size to be at least this height.

Returns: Floating-point value in pixel units. Can be used for the height of a symbol or a point in Vega.

is_point_in_merc_view(lon, lat, min_lon, max_lon, min_lat, max_lat)

Returns true if a latitude/longitude coordinate is within a mercator-projected view defined by min_lon/max_lon, min_lat/max_lat.

  • lon: Longitude coordinate of the point.

  • lat: Latitude coordinate of the point.

  • min_lon: Minimum longitude coordinate of the mercator-projected view.

  • max_lon: Maximum longitude coordinate of the mercator-projected view.

  • min_lat: Minimum latitude coordinate of the mercator-projected view.

  • max_lat: Maximum latitude coordinate of the mercator-projected view.

Returns:True if the point is within the view defined by the min_lon/max_lon, min_lat/max_lat; otherwise, false.

is_point_size_in_merc_view(lon, lat, meters, min_lon, max_lon, min_lat, max_lat)

Returns true if a latitude/longitude coordinate, offset by a distance in meters, is within a mercator-projected view defined by min_lon/max_lon, min_lat/max_lat.

  • lon: Longitude coordinate of the point.

  • lat: Latitude coordinate of the point.

  • meters: Distance in meters to offset the point by, in any direction.

  • min_lon: Minimum longitude coordinate of the mercator-projected view.

  • max_lon: Maximum longitude coordinate of the mercator-projected view.

  • min_lat: Minimum latitude coordinate of the mercator-projected view.

  • max_lat: Maximum latitude coordinate of the mercator-projected view.

Returns: True if the point is within the view defined by the min_lon/max_lon, min_lat/max_lat; otherwise, false.

is_point_in_view(pt, min_lon, max_lon, min_lat, max_lat)

Returns true if a latitude/longitude POINT defined in EPSG:4326 is within a mercator-projected view defined by min_lon/max_lon, min_lat/max_lat.

  • pt: The POINT to check. Must be defined in EPSG:4326 spatial reference system.

  • min_lon: Minimum longitude coordinate of the mercator-projected view.

  • max_lon: Maximum longitude coordinate of the mercator-projected view.

  • min_lat: Minimum latitude coordinate of the mercator-projected view.

  • max_lat: Maximum latitude coordinate of the mercator-projected view.

Returns: True if the point is within the view defined by min_lon/max_lon, min_lat/max_lat; otherwise, false.

is_point_size_in_view(pt, meters, min_lon, max_lon, min_lat, max_lat)

Returns true if a latitude/longitude POINT defined in EPSG:4326 is within a mercator-projected view defined by min_lon/max_lon, min_lat/max_lat.

  • pt: The POINT to check. Must be defined in EPSG:4326 spatial reference system.

  • meters: Distance in meters to offset the point by, in any direction.

  • min_lon: Minimum longitude coordinate of the mercator-projected view.

  • max_lon: Maximum longitude coordinate of the mercator-projected view.

  • min_lat: Minimum latitude coordinate of the mercator-projected view.

  • max_lat: Maximum latitude coordinate of the mercator-projected view.

Returns: True if a latitude/longitude POINT defined in EPSG:4326, offset by a distance in meters, is within the view defined by min_lon/max_lon, min_lat/max_lat; otherwise, false.