周边地点搜索免费API接口详解

<?php
/**
 * 周边地点搜索API - PHP调用示例
 */
class NearbySearchAPI {
    private $apiUrl = 'https://cn.apihz.cn/api/other/diming.php';
    private $id = '你的开发者ID';
    private $key = '你的开发者KEY';
    
    /**
     * 搜索周边地点
     */
    public function searchNearby($params) {
        // 构建请求参数
        $requestParams = array(
            'id' => $this->id,
            'key' => $this->key,
            'words' => $params['words'],
            'lon' => $params['lon'],
            'lat' => $params['lat'],
            'radius' => isset($params['radius']) ? $params['radius'] : 1000,
            'page' => isset($params['page']) ? $params['page'] : 1,
            'show' => isset($params['show']) ? $params['show'] : 1
        );
        
        // 可选参数处理
        if (isset($params['type'])) {
            $requestParams['type'] = $params['type'];
        }
        
        // 构建请求URL
        $queryString = http_build_query($requestParams);
        $url = $this->apiUrl . '?' . $queryString;
        
        // 发送GET请求
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        
        if (curl_error($ch)) {
            curl_close($ch);
            return array('code' => 400, 'msg' => '请求失败: ' . curl_error($ch));
        }
        
        curl_close($ch);
        
        // 解析返回结果
        $result = json_decode($response, true);
        
        if (json_last_error() !== JSON_ERROR_NONE) {
            return array('code' => 400, 'msg' => 'JSON解析失败');
        }
        
        return $result;
    }
    
    /**
     * 格式化显示结果
     */
    public function formatResults($results) {
        if ($results['code'] != 200) {
            return "搜索失败: " . $results['msg'];
        }
        
        $output = "找到 {$results['count']} 个结果，第 {$results['nowpage']} 页/共 {$results['allpage']} 页\n\n";
        
        foreach ($results['datas'] as $index => $item) {
            $output .= ($index + 1) . ". {$item['name']}\n";
            $output .= "   地址: {$item['address']}\n";
            $output .= "   距离: {$item['distance']}\n";
            $output .= "   坐标: {$item['lonlat']}\n";
            $output .= "   类型: " . ($item['poiType'] == '102' ? '公交站点' : 'POI地点') . "\n";
            
            // 如果是公交站点，显示线路信息
            if ($item['poiType'] == '102' && !empty($item['stationData'])) {
                $lines = array();
                foreach ($item['stationData'] as $line) {
                    $lines[] = $line['lineName'];
                }
                $output .= "   经过线路: " . implode('、', array_unique($lines)) . "\n";
            }
            
            $output .= "\n";
        }
        
        return $output;
    }
}
// 使用示例
$api = new NearbySearchAPI();
// 搜索参数
$searchParams = array(
    'words' => '公交',
    'lon' => 121.415,
    'lat' => 31.218,
    'radius' => 1000,
    'page' => 1,
    'show' => 1
);
// 执行搜索
$result = $api->searchNearby($searchParams);
// 输出结果
echo $api->formatResults($result);
?>

import requests
import json
from typing import Dict, List, Optional
class NearbySearchAPI:
    """周边地点搜索API Python封装类"""
    
    def __init__(self, developer_id: str, developer_key: str):
        self.api_url = "https://cn.apihz.cn/api/other/diming.php"
        self.id = developer_id
        self.key = developer_key
    
    def search_nearby(self, 
                     words: str, 
                     lon: float, 
                     lat: float, 
                     radius: int = 1000, 
                     page: int = 1, 
                     show: int = 1,
                     poi_type: Optional[str] = None) -> Dict:
        """
        搜索周边地点
        
        Args:
            words: 搜索关键词
            lon: 经度
            lat: 纬度
            radius: 搜索半径（米）
            page: 页码
            show: 显示模式（1=基础，2=详细）
            poi_type: 分类代码
            
        Returns:
            API响应结果
        """
        # 构建请求参数
        params = {
            'id': self.id,
            'key': self.key,
            'words': words,
            'lon': lon,
            'lat': lat,
            'radius': radius,
            'page': page,
            'show': show
        }
        
        if poi_type:
            params['type'] = poi_type
        
        try:
            # 发送GET请求
            response = requests.get(
                self.api_url, 
                params=params, 
                timeout=30,
                verify=False  # 根据实际情况调整SSL验证
            )
            
            if response.status_code != 200:
                return {
                    'code': 400,
                    'msg': f'HTTP请求失败: {response.status_code}'
                }
            
            # 解析JSON响应
            result = response.json()
            return result
            
        except requests.exceptions.RequestException as e:
            return {
                'code': 400,
                'msg': f'请求异常: {str(e)}'
            }
        except json.JSONDecodeError as e:
            return {
                'code': 400,
                'msg': f'JSON解析失败: {str(e)}'
            }
    
    def format_results(self, results: Dict) -> str:
        """格式化显示搜索结果"""
        if results.get('code') != 200:
            return f"搜索失败: {results.get('msg', '未知错误')}"
        
        output = []
        output.append(f"找到 {results.get('count', 0)} 个结果")
        output.append(f"第 {results.get('nowpage', 1)} 页/共 {results.get('allpage', 1)} 页")
        output.append("=" * 50)
        
        for i, item in enumerate(results.get('datas', []), 1):
            output.append(f"{i}. {item.get('name', '未知名称')}")
            output.append(f"   地址: {item.get('address', '未知地址')}")
            output.append(f"   距离: {item.get('distance', '未知')}")
            output.append(f"   坐标: {item.get('lonlat', '未知')}")
            
            poi_type = "POI地点" if item.get('poiType') == '101' else "公交站点"
            output.append(f"   类型: {poi_type}")
            
            # 公交站点线路信息
            if item.get('poiType') == '102' and item.get('stationData'):
                lines = set(station['lineName'] for station in item['stationData'])
                output.append(f"   经过线路: {'、'.join(lines)}")
            
            output.append("")
        
        return "\n".join(output)
    
    def search_bus_stations(self, lon: float, lat: float, radius: int = 1000) -> Dict:
        """专门搜索公交站点的便捷方法"""
        return self.search_nearby('公交', lon, lat, radius)
    
    def batch_search(self, searches: List[Dict]) -> List[Dict]:
        """批量搜索多个地点"""
        results = []
        for search in searches:
            result = self.search_nearby(**search)
            results.append(result)
        return results
# 使用示例
if __name__ == "__main__":
    # 初始化API（需要替换为实际的ID和KEY）
    api = NearbySearchAPI("你的开发者ID", "你的开发者KEY")
    
    # 示例1：搜索公交站点
    print("=== 搜索公交站点示例 ===")
    result = api.search_bus_stations(
        lon=121.415, 
        lat=31.218, 
        radius=1000
    )
    print(api.format_results(result))
    
    # 示例2：搜索酒店
    print("\n=== 搜索酒店示例 ===")
    result = api.search_nearby(
        words="酒店",
        lon=121.415,
        lat=31.218,
        radius=2000
    )
    print(api.format_results(result))