兴趣点API

接入教程

1. 阅读授权指南获取访问令牌
2. 准备测试环境凭据
3. 调用兴趣点搜索端点
4. 解析返回的JSON数据
5. 集成到您的应用程序中
6. 在生产环境部署前充分测试

Python查询兴趣点示例

python

import requests

# 配置API参数
BASE_URL = 'https://api.example.com'
ENDPOINT = '/v1/reference-data/locations/pois'
API_KEY = 'YOUR_API_KEY'

# 设置请求头
headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

# 构建查询参数
params = {
    'latitude': 40.7128,
    'longitude': -74.0060,
    'radius': 5,
    'categories': ['SIGHTS', 'RESTAURANTS']
}

# 发送GET请求
try:
    response = requests.get(
        f'{BASE_URL}{ENDPOINT}',
        headers=headers,
        params=params
    )
    response.raise_for_status()
    data = response.json()
    print(f'查询成功，找到{len(data.get("data", []))}个兴趣点')
except requests.exceptions.RequestException as e:
    print(f'请求失败: {e}')

PHP获取兴趣点示例

php

<?php

// API配置
$baseUrl = 'https://api.example.com';
$endpoint = '/v1/reference-data/locations/pois';
$apiKey = 'YOUR_API_KEY';

// 准备请求选项
$options = [
    'http' => [
        'method' => 'GET',
        'header' => "Authorization: Bearer {$apiKey}\r\n" .
                   "Content-Type: application/json\r\n",
        'ignore_errors' => true
    ]
];

// 构建查询参数
$queryParams = http_build_query([
    'latitude' => 40.7128,
    'longitude' => -74.0060,
    'radius' => 5,
    'categories' => ['SIGHTS', 'RESTAURANTS']
]);

$url = $baseUrl . $endpoint . '?' . $queryParams;

// 发送请求
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);

if ($response !== false) {
    $data = json_decode($response, true);
    echo '查询成功，找到' . count($data['data'] ?? []) . '个兴趣点';
} else {
    echo '请求失败';
}

?>

JavaScript搜索兴趣点示例

javascript

// API配置
const BASE_URL = 'https://api.example.com';
const ENDPOINT = '/v1/reference-data/locations/pois';
const API_KEY = 'YOUR_API_KEY';

// 构建查询参数
const params = new URLSearchParams({
    latitude: '40.7128',
    longitude: '-74.0060',
    radius: '5',
    categories: 'SIGHTS,RESTAURANTS'
});

// 发送GET请求
fetch(`${BASE_URL}${ENDPOINT}?${params.toString()}`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
    }
})
.then(response => {
    if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json();
})
.then(data => {
    console.log(`查询成功，找到${data.data?.length || 0}个兴趣点`);
    // 处理返回的兴趣点数据
})
.catch(error => {
    console.error('请求失败:', error);
});

常见问题

如何获取API访问令牌？

使用前需阅读官方授权指南获取访问令牌。测试环境基于生产环境子集，需按指南流程申请测试令牌。

API支持查询哪些类型的兴趣点？

该API支持查询景点、餐厅、酒店等多种兴趣点类型，可通过categories参数指定查询类别。

查询时有哪些必需的参数？

地理位置参数（经纬度）为必需参数，同时可配合半径、类别等可选参数进行精确查询。