GeoMarket API

Geospatial market analysis API for France. Given a GPS point, returns catchment area polygon, full demographics (population, gender, age × gender, households, CSP, activity), economy (income, purchasing power, unemployment, poverty), housing stock (type, tenure, rooms, construction year, car ownership), business density, competitor mapping, traffic score, and a weighted Business Opportunity Score (0–100, grade A–F) — all in a single unified JSON envelope.

原始信息汇总

GeoMarket API 数据集概述

基本信息

• API名称: GeoMarket API
• 功能描述: 用于法国地理空间市场分析的REST API。聚合地理空间、人口统计、经济和竞争情报数据，以评估任何GPS坐标点的商业潜力。
• 目标用户: 零售选址分析师、城市规划者、房地产专业人士和市场研究人员。

定价方案

• BASIC: $0.00 / 月
• PRO: $24.99 / 月
• ULTRA: $79.99 / 月
• MEGA: $199.99 / 月

核心功能与数据维度

• 影响区域计算: 根据中心坐标和半径（圆形近似）或出行时间等时线（通过OpenRouteService，支持驾车、步行或骑行）计算影响区域多边形。
• 人口统计 (INSEE RP 2020): 包含总人口、密度、性别比例、6个精细年龄组×性别人口、家庭结构、家庭类型、平均子女数、社会职业类别（农民、手工业者、高管、中级职业、雇员、工人、退休人员）以及15-64岁人口的活动率。
• 经济 (INSEE revenus localisés): 包含平均收入、中位收入、购买力指数（0-100标准化）、就业率、失业率（ILO定义）和贫困率。
• 住房 (INSEE RP 2020): 包含住房总量、占用状态（主要/次要/空置）、住房类型（房屋/公寓）、房间数分布（1-5+）、所有权（自住/私人租赁/社会住房）、入住时间分布、主要住宅建造年份、每户汽车拥有量、无车家庭比例以及有停车位家庭比例。
• 企业与竞争对手 (OpenStreetMap Overpass): 统计影响区域内所有企业的数量和类别，并识别给定商业类型的直接竞争对手（包含名称、距离和OSM标签）。
• 交通与可达性: 基于OSM道路密度（按道路等级加权）和公共交通站点（公交、地铁、有轨电车、市郊铁路）数量计算交通指数（0-100），并返回估计的每日人流量水平。
• 商业机会评分: 一个综合所有维度的加权评分（0-100，等级A-F），维度包括人口（25%）、购买力（20%）、竞争压力（20%）、交通（20%）和商业密度（15%）。包含法语的纯文本建议。
• 聚合端点: /demographics 和 /overview 端点可在单个并行请求中聚合多项服务。

技术规格

• API类型: REST API
• 基础URL: https://geomarket-api.p.rapidapi.com
• 认证方式: RapidAPI密钥认证（请求头: X-RapidAPI-Key: YOUR_RAPIDAPI_KEY）
• 响应格式: JSON
• 数据覆盖范围: 法国（本土及海外有数据的地区）

数据源

• OpenStreetMap (Overpass API): 用于企业、道路、公共交通数据。
• OpenRouteService: 用于生成等时线多边形（当使用 travel_time 参数时）。
• INSEE Géo (geo.api.gouv.fr): 用于市政区和人口数据。
• INSEE RP 2020: 用于部门级别的社会人口统计数据。

主要端点

1. GET /api/v1/catchment: 返回给定点周围影响区域的GeoJSON多边形。
2. GET /api/v1/catchment/population: 返回完整的人口统计数据。
3. GET /api/v1/catchment/economy: 返回经济数据。
4. GET /api/v1/catchment/businesses: 返回企业统计和分类数据。
5. GET /api/v1/catchment/competitors: 返回给定商业类型的直接竞争对手信息。
6. GET /api/v1/catchment/traffic: 返回交通和可达性数据。
7. GET /api/v1/catchment/housing: 返回住房存量数据。
8. GET /api/v1/catchment/score: 返回给定商业类型的商业机会评分。
9. GET /api/v1/catchment/demographics: 聚合端点，返回影响区域、完整人口数据、经济数据和住房数据。
10. GET /api/v1/catchment/overview: 聚合端点，返回所有服务的数据（影响区域、人口、经济、企业、交通、住房、机会评分和执行摘要）。

通用参数

参数	类型	必需	描述
lat	number	是	中心点的纬度（WGS84，-90 到 90）。
lng	number	是	中心点的经度（WGS84，-180 到 180）。
radius	number	否	半径，单位公里（0.1–50）。默认值：1。如果设置了 travel_time 则被忽略。
travel_time	integer	否	出行时间，单位分钟（1–120）。启用等时线模式（OpenRouteService）。替代 radius。
transport_mode	string	否	等时线出行模式：driving、walking 或 cycling。默认值：driving。
business_type	string	否	用于竞争对手/评分：商业类型。默认值：restaurant。

预定义的商业类型

restaurant, cafe, bar, supermarket, pharmacy, hotel, gym, bank, hairdresser, bakery, clothing, beauty。其他任何值将作为原始OpenStreetMap标签使用。

响应格式示例

成功响应

json { "success": true, "data": { ... }, "meta": { "computed_at": "2026-03-10T16:00:00.000Z", "sources": ["openstreetmap", "insee-geo"] } }

错误响应

json { "success": false, "error": { "code": "INVALID_PARAMS", "message": "lat: Number must be less than or equal to 90" } }

错误代码

代码	描述
INVALID_PARAMS	查询参数无效或缺失（例如，经纬度超出范围）。
EXTERNAL_API_ERROR	上游API（Overpass、INSEE、OpenRouteService）故障。
NOT_FOUND	请求的资源未找到。
RATE_LIMITED	请求过多；请遵守速率限制。
INTERNAL_ERROR	意外的服务器错误。

应用场景

• 选址分析: 比较多个新商店或餐厅的地址。
• 市场报告: 获取特定区域的人口统计和经济数据。
• 竞争情报: 按类型映射和统计竞争对手。
• 仪表板: 使用 /demographics 或 /overview 端点提供单页报告数据。
• 潜在客户评分: 使用机会评分对地点进行排名。

支持与许可

• 许可证: MIT。
• GitHub: https://github.com/kevinNJ20/GeoMarket-API
• RapidAPI支持: 使用API在RapidAPI页面上的讨论/支持频道。