地标建筑物识别与信息检索 API 接口教程，附完整调用代码示例

本教程基于阿里云云市场公开商品页的真实接口数据整理，内容仅描述该服务的实际能力、参数、计费与调用方式，供开发者与企业在接入前做技术评估参考。

（插图：服务调用架构）

1. 技能简介

地标建筑物识别与信息检索 查询 API 是一项面向图片的视觉识别接口服务，部署于阿里云云市场。它接收一张可正常解码、长宽比适宜的图像（建议不超过 2MB，支持 jpg / jpeg / png），自动分析画面内容并返回所识别到的地标或建筑物名称。该服务已获"国家二级等保"认证，数据通道具备基础安全保障，适用于需要将"图片→地点信息"进行结构化转换的各类业务系统。

2. 核心亮点

• 建筑物识别：针对城市建筑、地标楼宇等目标，输出可对应的名称结果。
• 地标识别：聚焦知名地标、广场、纪念性建筑等，返回标准化名称。
• OCR 图片识别（生活通用）：对通用生活场景图片做识别处理，适配多类输入。
• 标准化接入：通过阿里云云市场统一 API 网关调用，支持 APPCODE 简单认证与 AppKey & AppSecret 签名认证两种方式。
• 稳定可靠：稳定 地标建筑物识别与信息检索 服务接口 依托统一网关运行，适合长期生产环境使用。
• 结构化返回：响应为 JSON，业务结果封装在 showapi_res_body 中，便于程序解析。
• 安全合规：服务已取得国家二级等保认证，适合对数据安全有基本要求的生产环境。

3. 主要用途

地标建筑物识别与信息检索 接口的核心价值，是把"一张图"转化为"一个可检索的地点概念"。在旅游、出行、内容平台、智能相册、城市服务等场景中，用户上传图片后系统可自动标注拍摄地或景点名称，无需人工录入。对开发者而言，它把复杂的图像理解能力封装成一个 HTTP 接口，配合阿里云云市场的统一鉴权与计量，降低了接入与运维成本；对企业而言，可快速为现有 APP、小程序或 ERP 系统补充"以图识地"的能力，提升内容结构化与检索效率。

4. 功能特点

5. 操作流程

调用地标建筑物识别与信息检索 在线调用接口，推荐按以下五个步骤进行。

（插图：五步操作流程）

请求参数（Body）

接口基本信息

五步流程

1. 开通商品获取凭证：在阿里云云市场开通对应商品，获取 AppCode 或 AppKey & AppSecret。
2. 阅读接口文档：确认调用地址、Body 参数（img_base64 / img_url）与返回字段含义。
3. 准备图片：单图不超过 2MB，支持 jpg / jpeg / png；base64 与 URL 二选一。
4. 发起 POST 调用：在请求 Header 中携带 Authorization: APPCODE xxxxxxxx，提交图片参数。
5. 解析返回结果：读取 showapi_res_body.name 得到地标名称，ret_code = 0 表示成功。

6. 实际案例

下面以三类典型场景说明地标建筑物识别与信息检索 服务接口的落地方式。

案例一：旅游内容平台自动标注景点

某旅游 UGC 平台收到用户上传的旅行照片，调用接口后返回 name = "特拉法加广场"，系统自动为该图片打上地点标签，并关联同城其他景点，提升内容检索与推荐效率。

案例二：智能相册按地点归集

手机相册类应用将用户照片批量提交（循环调用）至接口，依据返回的 name 将照片按"地标 / 城市"分组，实现"按地点浏览"的相册视图，减少人工整理成本。

案例三：城市服务类小程序识图科普

城市导览小程序允许用户拍下陌生建筑，调用小程序 地标建筑物识别与信息检索 接口后，直接展示建筑名称与基本信息卡片，辅助市民与游客了解周边地标。

注：该接口为单图识别，无原生批量接口；批量场景可通过循环或受控并发调用实现，并注意调用频率与重试策略（详见第 9、15 章）。

7. 在线运行实录

以下为一次真实调用过程的参数设计与结果记录（基于云市场在线调试模块）。

（插图：API 在线调试模块）

调用参数设计

• 目标：识别一张含地标的公开图片
• 入参方式：使用 img_url 传入公网可访问的图片地址（亦可改用 img_base64）
• 请求方法：POST /ocrLandmark
• 鉴权：Authorization: APPCODE xxxxxxxx

运行追踪

• 请求追踪 ID（showapi_res_id）：642685910de376852d64c1a8
• 计量扣减（showapi_fee_num）：1（仅 HTTP 200 时扣减）
• 参考耗时：图像 OCR 类接口通常为数百毫秒级，以实际网络与图片复杂度为准

最终结果（节选）

{
   
  "showapi_res_error": "",
  "showapi_fee_num": 1,
  "showapi_res_code": 0,
  "showapi_res_id": "642685910de376852d64c1a8",
  "showapi_res_body": {
   
    "ret_code": 0,
    "remark": "无异常",
    "name": "特拉法加广场"
  }
}

结果解读

返回 showapi_res_code = 0 表示网关层正常，showapi_res_body.ret_code = 0 表示业务识别成功，name 字段给出识别到的地标名称"特拉法加广场"。当 ret_code 非 0 时，可依据 remark 与第 15 章错误码定位原因。

8. 接口接入示例 & 完整返回字段样例

Java 示例

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

public class LandmarkDemo {
   
    public static void main(String[] args) throws Exception {
   
        String host = "阿里云云市场网关地址";
        String path = "/ocrLandmark";
        String method = "POST";
        String appcode = "你自己的AppCode";

        String imgUrl = URLEncoder.encode("示例图片地址", "UTF-8");
        String body = "img_url=" + imgUrl;

        URL url = new URL(host + path);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod(method);
        conn.setRequestProperty("Authorization", "APPCODE " + appcode);
        conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
        conn.setDoOutput(true);
        conn.getOutputStream().write(body.getBytes("UTF-8"));

        BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
        StringBuilder sb = new StringBuilder();
        String line;
        while ((line = br.readLine()) != null) sb.append(line);
        System.out.println(sb.toString());
    }
}

PHP 示例

<?php
$host = "阿里云云市场网关地址";
$path = "/ocrLandmark";
$appcode = "你自己的AppCode";
$imgUrl = "示例图片地址";

$body = http_build_query(["img_url" => $imgUrl]);
$ch = curl_init($host . $path);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_HTTPHEADER => [
        "Authorization: APPCODE " . $appcode,
        "Content-Type: application/x-www-form-urlencoded;charset=utf-8"
    ],
    CURLOPT_RETURNTRANSFER => true
]);
$resp = curl_exec($ch);
curl_close($ch);
echo $resp;

Python 示例

import requests

host = "阿里云云市场网关地址"
path = "/ocrLandmark"
appcode = "你自己的AppCode"

resp = requests.post(
    host + path,
    data={
   "img_url": "示例图片地址"},
    headers={
   
        "Authorization": f"APPCODE {appcode}",
        "Content-Type": "application/x-www-form-urlencoded;charset=utf-8",
    },
    timeout=10,
)
print(resp.json())

JavaScript 示例

const appcode = "你自己的AppCode";
const body = new URLSearchParams();
body.append("img_url", "示例图片地址");

fetch("阿里云云市场网关地址/ocrLandmark", {
   
  method: "POST",
  headers: {
   
    Authorization: `APPCODE ${
     appcode}`,
    "Content-Type": "application/x-www-form-urlencoded;charset=utf-8",
  },
  body: body.toString(),
})
  .then((r) => r.json())
  .then((data) => console.log(data));

完整返回字段样例

{
   
  "showapi_res_error": "",
  "showapi_fee_num": 1,
  "showapi_res_code": 0,
  "showapi_res_id": "642685910de376852d64c1a8",
  "showapi_res_body": {
   
    "ret_code": 0,
    "remark": "无异常",
    "name": "特拉法加广场"
  }
}

9. 接口调用限制与服务规范

10. SLA 服务指标

以下为通用参考区间，精确数值以阿里云云市场控制台实时配置与商品协议为准；发布前建议以实际账户核对。

11. 计费套餐 & 免费试用政策

地标建筑物识别与信息检索 服务接口在阿里云云市场以"按调用次数"方式计量，提供免费试用与多档按量套餐。

（插图：计费档位）

计费要点

• 免费额度：新购可享 20 次免费试用，有效期 30 天；免费 地标建筑物识别与信息检索 接口 额度便于接入前做充分验证。
• 按量付费：按实际调用次数扣减，仅 HTTP 200 时计费。
• 阶梯优惠：单次成本随档位上升而降低（如 100 万次档约 50 元/万次）。
• 余量预警：余量为 0 后仍发送一次通知；提醒频率约每 3 天一次；预警阈值 =（历史所有资源包余量 + 当前订购包）× 20%。
• 过期提醒：资源包到期前 6~7 天发送一次通知（仅对有剩余余量的包提醒）。
• 发票：金额满 50 元可申请电子普票；满 200 元可申请电子专票。

商品与计费详情以阿里云云市场页面为准：地标识别商品页

12. 接口能力边界 & 服务范围说明

支持

• 输入一张可解码、长宽比适宜的图像，返回识别到的地标 / 建筑物名称。
• img_base64 与 img_url 两种入参方式。
• jpg / jpeg / png 格式，单图建议 ≤ 2MB。

不支持 / 边界

• 不保证对任意图片都能识别成功（无对应地标时可能返回空或失败）。
• 不支持超大图片（>2MB 建议压缩）与非标准格式。
• 无原生批量接口，批量需自行循环或并发调用。
• 返回结果为"名称"文本，不含经纬度、详细介绍等扩展信息。

免责声明

接口识别结果由算法模型给出，仅供参考，不对业务决策承担责任；请结合自身业务做必要校验。图片使用须符合相关法律法规与授权要求。

13. 竞品差异化竞争优势

14. 行业落地应用案例

15. 错误码说明 & 常见问题排查指南

（插图：业务返回码分类）

业务返回码位于 showapi_res_body.ret_code：

16. 独立 FAQ 常见问答专区

Q：这个接口支持识别哪些内容？
A：支持建筑物识别、地标识别，以及生活通用图片的 OCR 识别；对输入图片返回识别到的地标 / 建筑物名称。

Q：有免费试用吗？额度多少？
A：有。新购可享 20 次免费试用，有效期 30 天；另有 150 次起的多档按量套餐。

Q：响应速度和稳定性如何？
A：图像 OCR 类接口通常数百毫秒级返回；稳定性依托阿里云云市场统一网关。精确 SLA 以控制台与商品协议为准。

Q：支持批量或高并发吗？
A：接口为单图识别，无原生批量能力；批量可通过循环或受控并发调用实现，并注意 QPS 与重试策略。

Q：数据多久更新一次？
A：地标 / 建筑物知识库持续维护更新，无公开固定刷新周期。

Q：返回报错或无数据是什么原因？
A：可对照第 15 章错误码：10/20 多为参数与格式问题，40/50/60 与图片下载 / 大小 / 解析相关，70 为识别失败，80 为超时。

Q：支持私有化部署或定制吗？
A：商品页提供"提交定制需求"入口，可进一步对接商务咨询定制与私有化方案。

Q：适用于哪些系统？
A：可接入 ERP、小程序、APP 等；标准 HTTPS / POST 接口，多语言示例齐备。

Q：怎么计费？有隐藏费用吗？
A：按调用次数计费，仅 HTTP 200 时扣减次数，非 200 不扣费；档位与价格透明，详见第 11 章。

Q：如何上手获取凭证？
A：在阿里云云市场开通商品后获取 AppCode / AppKey，即可通过 APPCODE 调用，详见第 5 章。

商品与计费以阿里云云市场页面为准：地标识别商品页

17. 内容小结

地标建筑物识别与信息检索 API 是一项部署于阿里云云市场的图像识别接口，通过 POST /ocrLandmark 接收图片（base64 或 URL），返回识别到的地标 / 建筑物名称，结果封装在 JSON 的 showapi_res_body 中。其优势在于：标准 HTTPS 接入、APPCODE 即可快速调用、按次透明计费（含 20 次免费试用）、已取得国家二级等保认证，并提供在线客服与技术支持。

接入时需注意：单图 ≤ 2MB、jpg/jpeg/png；接口为单图识别，批量需循环或并发；仅 HTTP 200 扣费；遇到异常可依据 ret_code（10~90）对照错误码表排查。对稳定性与 SLA 的精确数值，建议以阿里云云市场控制台实时配置为准。

如需查看商品详情、计费档位与开通入口，可访问：地标识别商品页（阿里云云市场）