周边地点搜索API是一个功能强大的地理位置服务接口，由接口盒子提供。该接口允许开发者根据指定的经纬度坐标，搜索周边各类地点信息，包括公交站点、酒店、餐厅、商场等POI（兴趣点）数据。

<?php
/**
 * 周边地点搜索API - PHP调用示例
 */

class NearbySearchAPI {
    private $apiUrl = '接口盒子/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 = "接口盒子/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))

接口返回的数据包含丰富的字段信息，特别是公交站点数据，不仅包含站点基本信息，还包含经过该站点的所有公交线路详情，非常适合公共交通类应用开发。

支持按分类代码精确搜索，分类代码表提供了详细的类别定义，可以从餐饮、住宿、交通、购物等多个维度进行精准搜索。

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

编程语言

接口盒子周边地点搜索API提供精准POI数据查询，支持公交站点、酒店、餐厅等多类型地点搜索，最大10公里半径范围，分页显示30条结果，返回基础/详细信息两种模式，包含地址、距离、经纬度等关键数据，特别适合地图应用开发。

数据完整性

Python

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

周边地点搜索免费API接口详解-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐