公共非商业地理编码:地名/邮编→位置列表JSON,商业customer资源分开;未实测。
调用方式 / profile:open-meteo-geocoding-documentation · 组件版本:documentation-sha256:13b1651322f7e1190b76c82bdf165e63d7c13b297aca10ec506b384b9df0ed2c · 引用此版本与调用方式
已记录条件
- invocation_mode = api:支持。Supported within this profile and component version. 依据:open-meteo-geocoding-documentation-e1
- output_format = json:支持。Supported within this profile and component version. 依据:open-meteo-geocoding-documentation-e1
- auth_required = false:支持。Supported within this profile and component version. 依据:open-meteo-geocoding-documentation-e2
- output_structure = json_object:支持。Supported within this profile and component version. 依据:open-meteo-geocoding-documentation-e3
入口与前提
- 协议
- HTTPS GET
- 认证
- 本页apikey仅商业保留资源需要;此profile限定公共非商业端点,账户/用途资格未核验
- 价格是否查明
- unknown
- 配额是否查明
- unknown
https://geocoding-api.open-meteo.com/v1/search
- 仅官方文档声明,配方proposed;本站未连接、注册、调用第三方工具或核验实际账户。
- country/行政区过滤先于结果数量限制;歧义地点不能只取首条。
- GeoNames来源署名;商业端点与用途许可、数值额度和实际价格未核验。
配方 open-meteo-geocoding-documentation-recipe · 修订 1
所需调用能力:
- geocode_place_name
运行前提:
- 仅官方文档声明,配方proposed;本站未连接、注册、调用第三方工具或核验实际账户。
- country/行政区过滤先于结果数量限制;歧义地点不能只取首条。
- GeoNames来源署名;商业端点与用途许可、数值额度和实际价格未核验。
使用步骤:
- 准备已获授权的最小输入,核对本profile的适用范围、认证与费用;不填私人信息或凭据到公开示例。
- 候选GET https://geocoding-api.open-meteo.com/v1/search?name=Berlin&count=1;使用符合条件的最小查询。
- 未来获准调用后核对HTTP/MCP状态、返回结构与请求条件,保留缺项/限流/权限错误;本次没有执行此步骤。
- 输入约定
- name地名/邮编必填;count默认10、最多100,language/countryCode可选。输入是query,非JSON请求体。
- 输出约定
- 文档JSON对象results[]含坐标/国家/时区等;空字段可省,不保证门牌精度。
- 成功检查
- 待执行:检查400/JSON错误、匹配国家和行政区、坐标与时区;缺字段保留缺失。
- 失败与回退
- 条件不满足、认证/限流/结构错误即停止该调用并保留unknown;不切换付费服务、不猜工具名、不执行写操作。
适用证据
open-meteo-geocoding-documentation-e1 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/api-expansion-20261024-01/sources/open-meteo-geocoding-documentation.txt:L58-L69
- 来源版本
- documentation-sha256:13b1651322f7e1190b76c82bdf165e63d7c13b297aca10ec506b384b9df0ed2c
- 内容摘要
- 13b1651322f7e1190b76c82bdf165e63d7c13b297aca10ec506b384b9df0ed2c
- 采集时间
- 2026-10-24T03:59:29.7543456+00:00
The API endpoint https://geocoding-api.open-meteo.com/v1/search accepts a search term and returns a list of matching locations. URL parameters are listed below: ParameterFormatRequiredDefaultDescription nameStringYes Location name or postal code. Append a country or first-level administrative area after a comma to narrow the results. See matching rules and examples below. countIntegerNo10The number of search results to return. Up to 100 results can be retrieved. Country and administrative-area filters are applied before the result limit. formatStringNojsonBy default, results are returned as JSON. Alternatively, protobuf is supported for more efficient encoding and transfer. The .proto file to decode the protobuf message is available in the geocoding GitHub repository. languageStringNoenReturn translated results, if available, otherwise return english or the native location name. Lower-cased.
覆盖条件:invocation_mode=api; output_format=json
open-meteo-geocoding-documentation-e2 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/api-expansion-20261024-01/sources/open-meteo-geocoding-documentation.txt:L70-L71
- 来源版本
- documentation-sha256:13b1651322f7e1190b76c82bdf165e63d7c13b297aca10ec506b384b9df0ed2c
- 内容摘要
- 13b1651322f7e1190b76c82bdf165e63d7c13b297aca10ec506b384b9df0ed2c
- 采集时间
- 2026-10-24T03:59:29.7543456+00:00
apikeyStringNoOnly required to commercial use to access reserved API resources for customers. The server URL requires the prefix customer-. See pricing for more information.
覆盖条件:auth_required=false
open-meteo-geocoding-documentation-e3 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/api-expansion-20261024-01/sources/open-meteo-geocoding-documentation.txt:L93-L97
- 来源版本
- documentation-sha256:13b1651322f7e1190b76c82bdf165e63d7c13b297aca10ec506b384b9df0ed2c
- 内容摘要
- 13b1651322f7e1190b76c82bdf165e63d7c13b297aca10ec506b384b9df0ed2c
- 采集时间
- 2026-10-24T03:59:29.7543456+00:00
JSON Return Object On success a JSON object will be returned. Empty fields are not returned. E.g. admin4 will be missing if no fourth administrative level is available. { "results": [ {
覆盖条件:output_structure=json_object
结构化配方尚未提供或不适用于本版本;旧用法文字保留,连接与执行结果未知。