Aracılığıyla paylaş

h3_pointash3 işlevi

Belirtilen çözünürlükte sağlanan noktaya karşılık gelen H3 hücre kimliğini (BIGINT olarak) döndürür.

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL önizlemesi onay işareti evet olarak işaretlenmiş Databricks Runtime 11.3 LTS ve üzeri

Söz dizimi

h3_pointash3 ( geographyExpr, resolutionExpr )

Argümanlar

  • : WKB, WKT veya GeoJSON'da bir nokta coğrafyasını temsil eden BINARY veya STRING ifadesi. Coğrafyanın WGS84 koordinat başvuru sistemine başvuran derecelerde boylam ve enlem koordinatlarına sahip olması beklenir.
  • resolutionExpr: 0 ve 15 dahil olmak üzere arasında bir değer alması beklenen, H3 hücre kimliğinin çözünürlüğünü belirten bir INT ifadesi.

İadeler

Belirtilen çözünürlükte sağlanan noktaya karşılık gelen H3 hücre kimliğini (BIGINT olarak) döndürür.

Giriş ifadelerinden herhangi biri NULL ise işlev NULL döndürür. İlk giriş bağımsız değişkeni BINARY türündeyse, giriş değerinin bir noktanın WKB açıklaması olması beklenir. İlk giriş bağımsız değişkeni STRING türündeyse, giriş değerinin WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) veya bir noktanın GeoJSON açıklaması olması beklenir. Giriş noktasının boyutu 2B, 3DZ, 3DM veya 4D olabilir. WKB, WKTveya GeoJSON açıklamasındaki boylam ve enlem değerlerinin WGS84 koordinat başvuru sisteminde olması beklenir. İlk giriş boş noktaya karşılık geliyorsa işlev NULL döndürür.

Hata koşulları

  • binary türündeyse ve değer geçersiz bir WKB ise veya bir noktayı temsil etmiyorsageographyExpr, işlev WKB_PARSE_ERROR döndürür.
  • STRING türündeyse ve değer geçersiz bir WKT ise veya bir noktayı temsil etmiyorsageographyExpr, işlev WKT_PARSE_ERROR döndürür.
  • STRING türündeyse ve değer geçersiz bir GeoJSON ise veya bir noktayı temsil etmiyorsa geographyExpr işlev GEOJSON_PARSE_ERROR döndürür.
  • Eğer resolutionExpr, 0 değerinden küçük veya 15 değerinden büyükse işlev H3_INVALID_RESOLUTION_VALUE döndürür.

Örnekler

-- Simple example.
> SELECT h3_pointash3('POINT(100 45)', 6)
  604116085645508607

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_pointash3('POINT(-122.4783 37.8199)', 13)
  635714569676958015

-- The function returns NULL if the input is the empty point.
> SELECT h3_pointash3('{"type":"Point","coordinates":[]}', 15)
  null

-- Feeding a multipoint in WKT format instead of a point.
> SELECT h3_pointash3('MULTIPOINT(100 45)', 6)
  [WKT_PARSE_ERROR] Error parsing WKT: Invalid or unsupported type 'MULTIPOINT' at position 1

-- Feeding an invalid GeoJSON string ("type" value is not correct).
> SELECT h3_pointash3('{"type":"POINT","coordinates":[]}', 15)
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"POINT"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_pointash3(unhex('0201000000516b9a779c9e5ec0c5feb27bf2e84240'), 2)
  [WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1

-- Resolution is out of range.
> SELECT h3_pointash3('POINT(-122.4783 37.8199)', 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive