eBird鸟类观测数据API

接入教程

注册eBird账户后申请API密钥，使用REST端点查询区域观测数据

Python获取近期观测记录

python

import requests

url = 'https://api.example.com/v2/data/obs/geo/recent'
headers = {
    'X-eBirdApiToken': 'YOUR_API_KEY'
}
params = {
    'lat': 40.7128,
    'lng': -74.0060,
    'dist': 25
}
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f'Found {len(data)} observations')

PHP查询区域鸟类数据

php

<?php
$url = 'https://api.example.com/v2/data/obs/region/recent';
$apiKey = 'YOUR_API_KEY';
$regionCode = 'US-NY';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . '?region=' . $regionCode);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-eBirdApiToken: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo 'Observations count: ' . count($data);
curl_close($ch);
?>

JavaScript获取显著观察记录

javascript

const fetchObservations = async () => {
    const url = 'https://api.example.com/v2/data/obs/geo/notable';
    const params = new URLSearchParams({
        lat: 34.0522,
        lng: -118.2437,
        back: 7
    });
    
    const response = await fetch(`${url}?${params}`, {
        headers: {
            'X-eBirdApiToken': 'YOUR_API_KEY'
        }
    });
    
    const data = await response.json();
    console.log(`Notable observations: ${data.length}`);
    return data;
};

fetchObservations();

常见问题

如何获取API密钥？

访问eBird官网注册账户，在开发者页面申请API密钥。免费层级有限制，商业用途需联系授权。

API请求频率有限制吗？

是的，免费API密钥通常有每分钟和每日请求限制，具体限制请查阅最新文档。建议合理缓存数据避免超额。

支持哪些地理区域查询？

支持国家代码、行政区代码、经纬度坐标等多种区域标识符。可使用区域代码如'US-CA'查询加利福尼亚州数据。