如何在Typesense Instantsearch Adapter中实现多边形区域地理定位过滤

1. 修正地理字段的Schema定义 #

你当前使用float[]类型存储经纬度无法触发Typesense的地理过滤逻辑，需要将字段类型调整为专门的geopoint类型：

{"name": "_geoloc", "type": "geopoint" , "facet": true }

修改Schema后需要重新导入全量数据，确保所有_geoloc字段存储格式为[纬度, 经度]，经纬度顺序不能颠倒。

2. 调整InstantSearch Adapter参数位置 #

geoLocationField和insidePolygon不属于Adapter顶层配置项，需要放到additionalSearchParameters中才会随搜索请求发送到服务端生效。同时建议手动闭合多边形坐标，保证过滤范围准确。

修正后的完整配置如下：

const polygon = [
    42.01,-124.31,
    48.835509470063045,-124.40453125000005,
    45.01082951668149,-65.95726562500005,
    31.247243545293433,-81.06578125000004,
    25.924152577235226,-97.68234374999997,
    32.300311895879545,-117.54828125,
    42.01,-124.31 // 手动闭合多边形，和第一个点坐标一致
];

const typesenseInstantsearchAdapter = new TypesenseInstantSearchAdapter({
    server: {
        apiKey: "xyz",
        nodes: [{
            host: "localhost",
            port: "8108",
            protocol: "http",
        }],
        cacheSearchResultsForSeconds: 2 * 60,
    },
    additionalSearchParameters: {
        queryBy: "name",
        geoLocationField: "_geoloc",
        insidePolygon: [polygon]
    },
});

3. 验证过滤规则 #

配置修改完成后，可以先直接调用Typesense原生搜索接口验证过滤逻辑是否正常，排除InstantSearch层的配置干扰：

# 替换<your_collection_name>为实际的集合名称
curl "http://localhost:8108/collections/<your_collection_name>/documents/search?q=*&query_by=name&geo_location_field=_geoloc&inside_polygon=(42.01,-124.31,48.835509470063045,-124.40453125000005,45.01082951668149,-65.95726562500005,31.247243545293433,-81.06578125000004,25.924152577235226,-97.68234374999997,32.300311895879545,-117.54828125,42.01,-124.31)" \
-H "X-TYPESENSE-API-KEY: xyz"

内容的提问来源于stack exchange，提问作者jacklogan