Web服务API

https://api.map.baidu.com/

{
  "status": 0,
  "message": "ok",
  "result": {}
}

// 实现请求限流
class RateLimiter {
  constructor(qps = 50) {
    this.qps = qps;
    this.queue = [];
    this.lastTime = 0;
  }

  async request(url) {
    const now = Date.now();
    const elapsed = now - this.lastTime;
    const minInterval = 1000 / this.qps;

    if (elapsed < minInterval) {
      await new Promise(resolve => setTimeout(resolve, minInterval - elapsed));
    }

    this.lastTime = Date.now();
    return fetch(url);
  }
}

const limiter = new RateLimiter(50);

GET https://api.map.baidu.com/place/v2/search?query=餐厅&region=北京&output=json&ak=您的密钥

{
  "status": 0,
  "message": "ok",
  "total": 100,
  "results": [
    {
      "name": "餐厅名称",
      "location": {
        "lng": 116.404,
        "lat": 39.915
      },
      "address": "详细地址",
      "province": "北京市",
      "city": "北京市",
      "area": "海淀区",
      "telephone": "电话号码",
      "uid": "唯一标识",
      "street_id": "街道ID",
      "detail": 1,
      "detail_info": {
        "tag": "标签",
        "rating": 4.5,
        "price": 80,
        "shop_hours": "营业时间"
      }
    }
  ]
}

GET https://api.map.baidu.com/place/v2/search?query=餐厅&location=39.915,116.404&radius=1000&output=json&ak=您的密钥

GET https://api.map.baidu.com/place/v2/search?query=餐厅&bounds=39.915,116.404,39.975,116.414&output=json&ak=您的密钥

GET https://api.map.baidu.com/place/v2/detail?uid=地点UID&output=json&ak=您的密钥

{
  "status": 0,
  "result": {
    "uid": "xxx",
    "name": "地点名称",
    "location": {"lng": 116.404, "lat": 39.915},
    "address": "详细地址",
    "telephone": "电话",
    "detail_info": {
      "tag": "分类标签",
      "rating": 4.5,
      "price": 80,
      "shop_hours": "营业时间",
      "alias": "别名",
      "description": "描述",
      "image": "图片URL",
      "photos": ["图片数组"],
      "scope_type": "类型",
      "scope_grade": "等级",
      "content_tag": "内容标签"
    }
  }
}

GET https://api.map.baidu.com/place/v2/suggestion?query=中关村&region=北京&output=json&ak=您的密钥

{
  "status": 0,
  "result": [
    {
      "name": "中关村",
      "location": {"lng": 116.31, "lat": 39.98},
      "uid": "xxx",
      "city": "北京市",
      "district": "海淀区",
      "business": "中关村"
    }
  ]
}

GET https://api.map.baidu.com/geocoding/v3/?address=北京市海淀区上地十街10号&output=json&ak=您的密钥

{
  "status": 0,
  "result": {
    "location": {
      "lng": 116.308,
      "lat": 40.056
    },
    "precise": 1,
    "confidence": 80,
    "comprehension": 100,
    "level": "道路"
  }
}

GET https://api.map.baidu.com/reverse_geocoding/v3/?location=40.056,116.308&output=json&ak=您的密钥

{
  "status": 0,
  "result": {
    "location": {
      "lng": 116.308,
      "lat": 40.056
    },
    "formatted_address": "北京市海淀区上地十街10号",
    "business": "上地",
    "addressComponent": {
      "country": "中国",
      "country_code": 0,
      "country_code_iso": "CHN",
      "country_code_iso2": "CN",
      "province": "北京市",
      "city": "北京市",
      "city_level": 2,
      "district": "海淀区",
      "town": "上地街道",
      "adcode": "110108",
      "street": "上地十街",
      "street_number": "10号",
      "direction": "附近",
      "distance": "10"
    },
    "pois": [
      {
        "addr": "详细地址",
        "cp": "数据来源",
        "direction": "方向",
        "distance": "距离",
        "name": "POI名称",
        "poiType": "POI类型",
        "point": {"x": 116.308, "y": 40.056},
        "tag": "标签",
        "tel": "电话",
        "uid": "唯一标识",
        "zip": "邮编"
      }
    ],
    "roads": [],
    "poiRegions": []
  }
}

GET https://api.map.baidu.com/direction/v2/driving?origin=40.056,116.308&destination=39.915,116.404&output=json&ak=您的密钥

{
  "status": 0,
  "result": {
    "routes": [
      {
        "distance": 12000,
        "duration": 1800,
        "toll": 10,
        "toll_distance": 5000,
        "toll_info": {"toll_price": 10, "toll_mileage": 5},
        "restriction": 0,
        "traffic_lights": 15,
        "steps": [
          {
            "distance": 500,
            "duration": 60,
            "road": "道路名称",
            "instruction": "沿道路名称行驶500米",
            "path": "坐标串",
            "start_location": {"lng": 116.308, "lat": 40.056},
            "end_location": {"lng": 116.310, "lat": 40.060},
            "turn_type": "直行",
            "road_type": 0,
            "direction": "东",
            "traffic_condition": [
              {"distance": 300, "status": 1},
              {"distance": 200, "status": 2}
            ]
          }
        ]
      }
    ]
  }
}

GET https://api.map.baidu.com/direction/v2/riding?origin=40.056,116.308&destination=39.915,116.404&output=json&ak=您的密钥

GET https://api.map.baidu.com/direction/v2/walking?origin=40.056,116.308&destination=39.915,116.404&output=json&ak=您的密钥

GET https://api.map.baidu.com/direction/v2/transit?origin=40.056,116.308&destination=39.915,116.404&city=北京&output=json&ak=您的密钥

GET https://api.map.baidu.com/routematrix/v2/driving?origins=40.056,116.308&destinations=39.915,116.404&output=json&ak=您的密钥

{
  "status": 0,
  "result": [
    {
      "distance": {
        "text": "12.5公里",
        "value": 12500
      },
      "duration": {
        "text": "20分钟",
        "value": 1200
      },
      "origin": {"lng": 116.308, "lat": 40.056},
      "destination": {"lng": 116.404, "lat": 39.915}
    }
  ]
}

GET https://api.map.baidu.com/staticimage/v2?center=116.404,39.915&zoom=15&width=400&height=300&ak=您的密钥

markers=116.404,39.915|116.408,39.920
markerStyles=样式配置

markerStyles=larger,l,A,0xFF0000

paths=116.404,39.915;116.408,39.920;116.410,39.925
pathStyles=样式配置

GET https://api.map.baidu.com/geoconv/v1/?coords=114.21892734521,29.575429778924&from=1&to=5&ak=您的密钥

{
  "status": 0,
  "result": [
    {
      "x": 114.230,
      "y": 29.583
    }
  ]
}

GET https://api.map.baidu.com/api_custom/v1/boundaries?keyword=海淀区&output=json&ak=您的密钥

{
  "status": 0,
  "boundaries": [
    {
      "name": "海淀区",
      "code": "110108",
      "boundary": "坐标点串"
    }
  ]
}

// baidu-map-sdk.js
const crypto = require('crypto');
const axios = require('axios');

class BaiduMapSDK {
  constructor(ak, sk = null) {
    this.ak = ak;
    this.sk = sk;
    this.baseUrl = 'https://api.map.baidu.com';
  }

  // 生成SN签名
  generateSn(query) {
    if (!this.sk) return null;
    const str = query + this.sk;
    return crypto.createHash('md5').update(encodeURIComponent(str)).digest('hex');
  }

  // 通用请求方法
  async request(path, params) {
    const queryString = new URLSearchParams(params).toString();
    const sn = this.generateSn(queryString);
    const url = `${this.baseUrl}${path}?${queryString}${sn ? '&sn=' + sn : ''}`;

    const response = await axios.get(url);
    
    if (response.data.status !== 0) {
      throw new Error(`API错误: ${response.data.message || response.data.status}`);
    }

    return response.data;
  }

  // 地理编码
  async geocode(address, city = null) {
    const params = { address, ak: this.ak, output: 'json' };
    if (city) params.city = city;
    return this.request('/geocoding/v3/', params);
  }

  // 逆地理编码
  async reverseGeocode(lat, lng) {
    return this.request('/reverse_geocoding/v3/', {
      location: `${lat},${lng}`,
      ak: this.ak,
      output: 'json'
    });
  }

  // 地点搜索
  async searchPlace(query, region, options = {}) {
    return this.request('/place/v2/search', {
      query,
      region,
      ak: this.ak,
      output: 'json',
      ...options
    });
  }

  // 路线规划
  async drivingRoute(originLat, originLng, destLat, destLng, options = {}) {
    return this.request('/direction/v2/driving', {
      origin: `${originLat},${originLng}`,
      destination: `${destLat},${destLng}`,
      ak: this.ak,
      output: 'json',
      ...options
    });
  }

  // 坐标转换
  async convertCoords(coords, from = 1, to = 5) {
    const coordsStr = coords.map(c => `${c.lng},${c.lat}`).join('|');
    return this.request('/geoconv/v1/', {
      coords: coordsStr,
      from,
      to,
      ak: this.ak,
      output: 'json'
    });
  }
}

module.exports = BaiduMapSDK;

const BaiduMapSDK = require('./baidu-map-sdk');

// 初始化SDK
const bmap = new BaiduMapSDK('您的AK', '您的SK');

// 地理编码
async function test() {
  try {
    // 地址转坐标
    const geoResult = await bmap.geocode('北京市海淀区上地十街10号');
    console.log('坐标：', geoResult.result.location);

    // 坐标转地址
    const reverseResult = await bmap.reverseGeocode(39.915, 116.404);
    console.log('地址：', reverseResult.result.formatted_address);

    // 地点搜索
    const searchResult = await bmap.searchPlace('餐厅', '北京', { page_size: 10 });
    console.log('搜索结果：', searchResult.results);

    // 路线规划
    const routeResult = await bmap.drivingRoute(39.915, 116.404, 40.056, 116.308);
    console.log('距离：', routeResult.result.routes[0].distance);
  } catch (error) {
    console.error('错误：', error.message);
  }
}

test();

import hashlib
import requests
from urllib.parse import quote

class BaiduMapSDK:
    def __init__(self, ak, sk=None):
        self.ak = ak
        self.sk = sk
        self.base_url = 'https://api.map.baidu.com'

    def _generate_sn(self, query):
        if not self.sk:
            return None
        temp = query + self.sk
        return hashlib.md5(quote(temp).encode('utf-8')).hexdigest()

    def _request(self, path, params):
        params['ak'] = self.ak
        params['output'] = 'json'
        query = '&'.join([f'{k}={v}' for k, v in params.items()])
        sn = self._generate_sn(query)
        url = f'{self.base_url}{path}?{query}'
        if sn:
            url += f'&sn={sn}'
        
        response = requests.get(url)
        data = response.json()
        
        if data['status'] != 0:
            raise Exception(f"API错误: {data.get('message', data['status'])}")
        
        return data

    def geocode(self, address, city=None):
        params = {'address': address}
        if city:
            params['city'] = city
        return self._request('/geocoding/v3/', params)

    def reverse_geocode(self, lat, lng):
        return self._request('/reverse_geocoding/v3/', {
            'location': f'{lat},{lng}'
        })

    def search_place(self, query, region, **options):
        params = {'query': query, 'region': region, **options}
        return self._request('/place/v2/search', params)

    def driving_route(self, origin_lat, origin_lng, dest_lat, dest_lng, **options):
        params = {
            'origin': f'{origin_lat},{origin_lng}',
            'destination': f'{dest_lat},{dest_lng}',
            **options
        }
        return self._request('/direction/v2/driving', params)

const crypto = require('crypto');

function generateSn(ak, sk, query) {
  const str = query + sk;
  return crypto.createHash('md5').update(encodeURIComponent(str)).digest('hex');
}

// 使用示例
const ak = '您的AK';
const sk = '您的SK';
const query = '/geocoding/v3/?address=北京&ak=' + ak + '&output=json';
const sn = generateSn(ak, sk, query);

async function searchPlace(query) {
  try {
    const response = await fetch(url);
    const data = await response.json();
    
    if (data.status !== 0) {
      throw new Error(`API错误: ${data.message || data.status}`);
    }
    
    return data.results;
  } catch (error) {
    console.error('请求失败:', error);
    throw error;
  }
}

const cache = new Map();
const CACHE_TTL = 5 * 60 * 1000; // 5分钟缓存

async function searchWithCache(query) {
  const cacheKey = `search_${query}`;
  
  // 检查缓存
  if (cache.has(cacheKey)) {
    const cached = cache.get(cacheKey);
    if (Date.now() - cached.time < CACHE_TTL) {
      return cached.data;
    }
  }
  
  // 请求数据
  const result = await searchPlace(query);
  
  // 更新缓存
  cache.set(cacheKey, {
    data: result,
    time: Date.now()
  });
  
  return result;
}

// 定期清理过期缓存
setInterval(() => {
  const now = Date.now();
  for (const [key, value] of cache.entries()) {
    if (now - value.time > CACHE_TTL) {
      cache.delete(key);
    }
  }
}, 60 * 1000);

// 批量地理编码
async function batchGeocode(addresses) {
  const results = [];
  const concurrency = 10; // 并发数
  
  for (let i = 0; i < addresses.length; i += concurrency) {
    const batch = addresses.slice(i, i + concurrency);
    const promises = batch.map(addr => geocode(addr));
    const batchResults = await Promise.all(promises);
    results.push(...batchResults);
    
    // 避免超过QPS限制
    await new Promise(resolve => setTimeout(resolve, 100));
  }
  
  return results;
}