baidu-poi-search

Baidu Map POI Search

L0: One-Sentence Summary

Input a company name, call the Baidu Map Place Search API, and return normalized POI data (name / address / coordinates / province & city).

L1: Overview

• Data source: Baidu Map Open Platform Place Search API v2
• Auth: AK (free quota for individual developers)
• Invocation: HTTP GET (curl / HttpRequest tool)
• Prerequisites: no browser, no extra dependencies — pure REST API

Credential Setup

This skill requires a Baidu Map AK (access key):

1. Register a developer account at the Baidu Map Open Platform
2. Console → App Management → Create an app (enable the "Place Search" service; choose the empty-whitelist 0.0.0.0/0 AK type)
3. Export the AK as the environment variable BAIDU_MAP_AK, or replace the {BAIDU_MAP_AK} placeholder in the commands below

If the local DesireCore service catalog already registers the Baidu Map service (endpoint https://api.map.baidu.com), prefer calling it through the catalog so credentials are managed centrally.

L2: Procedure

1. Build the request

curl -s --max-time 15 --ssl-no-revoke \
  "https://api.map.baidu.com/place/v2/search?query={company-name-URL-encoded}&region={city-or-nationwide}&output=json&page_size=20&ak=${BAIDU_MAP_AK}"

Parameters:

Param	Value	Notes
query	Company name (URL-encoded)	e.g. 华为技术有限公司 → %E5%8D%8E%E4%B8%BA%E6%8A%80%E6%9C%AF%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8
region	City name or 全国 (nationwide)	Scope; use nationwide when unsure
output	json	Fixed
page_size	20	Max 20 per page
ak	{BAIDU_MAP_AK}	Baidu Map AK (free for individual developers)

2. Interpret the response

• status == 0: success, extract results[]
• status != 0: failure, check message (101 = AK missing, 200 = AK disabled, 302 = quota exceeded)

3. Normalized mapping

Map each entry in results[] to:

{
  "source": "baidu-poi",
  "company_name": "{user input}",
  "poi_name": "{result.name}",
  "address": "{result.address}",
  "latitude": "{result.location.lat}",
  "longitude": "{result.location.lng}",
  "province": "{result.province}",
  "city": "{result.city}"
}