功能函數項
外掛程式功能函數可以用在filter子句作為過濾和篩選條件,而傳回值為數值型的功能函數在sort子句中,用來做排序。
其中功能函數參數出現的文檔欄位需根據對應函數文檔提示,建立為索引或屬性.
in_query_polygon : 判斷文檔中指定的點是否在使用者指定的多邊形範圍內
1.詳細用法:
in_query_polygon(polygon_key, doc_point)
2.參數:
polygon_key:kvpairs子句中定義的使用者參數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.注意事項:
函數參數依賴欄位需建立為屬性