全部產品
Search
文件中心

:in_query_polygon

更新時間:Jul 13, 2024

功能函數項

外掛程式功能函數可以用在filter子句作為過濾和篩選條件,而傳回值為數值型的功能函數在sort子句中,用來做排序。

其中功能函數參數出現的文檔欄位需根據對應函數文檔提示,建立為索引或屬性.

in_query_polygon : 判斷文檔中指定的點是否在使用者指定的多邊形範圍內

1.詳細用法:

in_query_polygon(polygon_key, doc_point)

2.參數:

  • polygon_keykvpairs子句中定義的使用者參數key,多邊形頂點儲存在對應的value中。類型必須為DOUBLE_ARRAY,欄位值依次為配送多邊形有序定點的x,y座標(先x後y),頂點務必保證有序(順時針、逆時針均可)!!座標之間用逗號分隔,格式為:xA,yA,xB,Yb。支援多個多邊形,多邊形與多邊形之間通過分號(;)分隔。

  • doc_point:類型必須為DOUBLE_ARRAY,表示需要判斷的點。只包含兩個值,依次為點的x,y座標

3.傳回值:

int,返回匹配到的第一個多邊形的下標(例:匹配到第一個多邊形就返回1,匹配到第二個多邊形就返回2,以此類推),沒有匹配則返回0

4.適用情境:

情境1

搜尋銀泰商圈(xA,yA,xB,Yb,xC,Yc;xD,yD,xE,yE,xF,yF,xG,yG)的外婆家,商家位置存放在point欄位中

query=default:’外婆家’&&filter=in_query_polygon(“polygons”, point)>0&&kvpairs=polygons:xA\,yA\,xB\,Yb\,xC\,Yc;xD\,yD\,xE\,yE\,xF\,yF\,xG\,yG

5.注意事項:

  • 函數參數依賴欄位需建立為屬性