GeoPolygonQuery memfilter baris berdasarkan area geografis berbentuk poligon. Tablestore mengembalikan baris yang nilai kolom GeoPoint-nya berada di dalam poligon yang ditentukan. Gunakan kueri ini untuk memfilter data berdasarkan batas geografis kompleks, seperti zona pengiriman, wilayah administratif, atau area cakupan layanan.
Struktur data
message GeoPolygonQuery {
optional string field_name = 1;
repeated string points = 2;
}
|
Parameter |
Type |
Wajib |
Deskripsi |
|
field_name |
string |
Ya |
Nama kolom atribut yang akan dikueri. Tipe kolom harus berupa GeoPoint. |
|
points |
string |
Ya |
Pasangan koordinat dari titik-titik sudut yang mendefinisikan poligon. Setiap nilai harus dalam format |
Penting: Format koordinat adalahlatitude,longitude— latitude ditulis terlebih dahulu. Format ini berkebalikan dengan GeoJSON, yang menggunakan urutanlongitude,latitude. Menukar urutan ini merupakan salah satu penyebab paling umum hasil kueri poligon geografis yang tidak akurat.