pelias/pip-service

Pelias Point-in-Polygon Service

概述

Pelias Point-in-Polygon Service（点在多边形服务）是Pelias开源地理编码引擎生态系统的一部分，专门用于判断一个地理坐标点是否位于指定的多边形区域内。该服务提供高效的空间关系判断能力，为地理空间应用提供基础支持。

核心功能与特性

• 高效判断地理点是否位于多边形区域内
• 支持多种地理数据格式输入
• 提供REST API接口，便于集成到各类应用中
• 轻量级设计，资源占用低
• 可水平扩展，适应不同负载需求

使用场景与适用范围

• 基于地理位置的服务访问控制
• 区域内数据统计与分析
• 地理围栏应用开发
• 位置感知型应用功能实现
• 地理空间数据处理流程

使用方法与配置说明

基本使用

Docker Run 命令

bash
docker run -d -p 3000:3000 --name pelias-pip-service pelias/pip-service

Docker Compose 配置

yaml
version: '3'
services:
  pip-service:
    image: pelias/pip-service
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
    restart: always

API 使用

服务启动后，可通过HTTP POST请求调用点在多边形判断功能：

bash
curl -X POST http://localhost:3000/check \
  -H "Content-Type: application/json" \
  -d '{
    "point": { "lat": 40.7128, "lng": -74.0060 },
    "polygon": {
      "type": "Polygon",
      "coordinates": [
        [
          [-74.01, 40.70],
          [-74.01, 40.72],
          [-73.99, 40.72],
          [-73.99, 40.70],
          [-74.01, 40.70]
        ]
      ]
    }
  }'

环境变量配置

数据准备

该服务需要预先加载多边形数据，可通过以下方式提供：

1. 本地文件系统：将GeoJSON格式的多边形数据文件挂载到容器内/data目录
2. 数据库连接：通过环境变量配置数据库连接信息，从数据库加载多边形数据

性能优化

• 对于频繁使用的多边形，服务会自动缓存以提高查询性能
• 可通过调整CACHE_SIZE环境变量优化缓存性能
• 对于大规模多边形数据，建议使用数据库存储并建立空间索引