24 个端点,涵盖来自 Open-Meteo 的当前和预报天气、空气质量指数(PM2.5、PM10、臭氧)、IP 地理定位、时区查询、日出/日落时间、250 个国家的综合数据、60+ 个国家的邮政编码查询、海洋波浪和涌浪数据、通过 ADS-B 进行的实时航班追踪、美国沿海站点的 NOAA 潮汐预测,以及将地名转换为坐标的地理编码搜索。
基础 URL: https://nordapi.ee/api/v1
GET /weather/current
获取任何位置的当前天气状况,包括温度、湿度、体感温度、降水、风速和风向以及天气描述代码。支持按纬度/经度坐标或按城市名称查询(支持 30 个主要城市)。数据每 15 分钟从 Open-Meteo 更新,由国家气象服务提供支持。适用于天气小组件、户外活动规划器和基于位置的应用。
lat
可选
lon
可选
city
可选
curl "https://nordapi.ee/api/v1/weather/current?city=oslo"
GET /weather/forecast
获取最多 16 天的多天天气预报,含每日最高/最低温度、降水概率、风速和天气代码。支持坐标或城市名称查询。适用于旅行规划应用、活动安排工具、农业仪表板和帮助用户围绕未来天气条件进行规划的任何功能。数据来自 Open-Meteo 预报模型。
lat
可选
lon
可选
city
可选
days
可选
默认: 7
curl "https://nordapi.ee/api/v1/weather/forecast?city=tokyo&days=7"
GET /weather/cities
获取支持按城市名称查询天气的 30 个主要城市完整列表。返回城市名称及其坐标。使用此列表填充城市下拉菜单或在调用天气端点之前验证用户输入。覆盖各大洲的全球首都和主要城市中心。
curl https://nordapi.ee/api/v1/weather/cities
GET /weather/historical
从 Open-Meteo 档案中检索任何位置和日期范围的历史天气数据。返回过去日期的每日温度、降水、风力和其他天气变量。需要纬度/经度坐标和日期范围。适用于气候分析、农业研究、保险理赔验证、事件复盘和将当前条件与历史常态进行比较。
lat
必填
lon
必填
start_date
必填
end_date
必填
curl "https://nordapi.ee/api/v1/weather/historical?lat=59.9&lon=10.7&start_date=2025-01-01&end_date=2025-01-31"
GET /airquality/current
获取地球上任何位置的当前空气质量数据,包括 PM2.5、PM10、臭氧 (O3)、二氧化氮 (NO2) 和总体空气质量指数 (AQI) 评分。需要纬度和经度坐标。对注重健康的应用、户外运动规划器、过敏追踪器和环境监测仪表板至关重要。数据来自 Open-Meteo 空气质量模型。
lat
必填
lon
必填
curl "https://nordapi.ee/api/v1/airquality/current?lat=59.9&lon=10.7"
GET /airquality/forecast
获取任何位置的 3 天逐小时空气质量预报,包括预测的 PM2.5、PM10、臭氧和 AQI 水平。适用于规划户外活动、向易感人群发出即将到来的空气质量差的预警和构建主动健康通知系统。数据来自 Open-Meteo 预报模型。
lat
必填
lon
必填
curl "https://nordapi.ee/api/v1/airquality/forecast?lat=59.9&lon=10.7"
GET /geo/ip
自动对请求客户端的 IP 地址进行地理定位。返回检测到的 IP、近似经纬度、城市、地区、国家、时区和 ISP 信息。无需参数——使用调用者的 IP。适用于按位置个性化内容、自动选择语言/货币、欺诈检测和需要映射用户位置的分析仪表板。
curl https://nordapi.ee/api/v1/geo/ip
GET /geo/ip/:ip
对任何特定的 IPv4 或 IPv6 地址进行地理定位。返回给定 IP 的近似经纬度、城市、地区、国家、时区和 ISP 信息。适用于查找服务器 IP 的位置、调查可疑登录尝试、用地理上下文丰富日志数据和构建基于 IP 的访问控制系统。
ip
必填
curl https://nordapi.ee/api/v1/geo/ip/8.8.8.8
GET /geo/timezone
通过地理坐标或时区名称查询时区信息。返回时区标识符(例如 Europe/Oslo)、当前本地时间、UTC 偏移和夏令时状态。适用于需要以用户本地时区显示时间的日程安排应用、跨时区的会议规划器和在 UTC 与本地时间之间转换的任何功能。
lat
可选
lon
可选
zone
可选
curl "https://nordapi.ee/api/v1/geo/timezone?lat=59.9&lon=10.7"
GET /geo/sun
获取任何位置和日期的日出、日落、正午和民用/航海/天文晨昏蒙影时间。所有时间以 UTC 返回。适用于摄影应用(黄金时段规划)、户外活动安排器、智能家居灯光自动化、宗教活动应用和太阳能发电量估算。在具有极端日照变化的北欧地区尤其相关。
lat
必填
lon
必填
date
可选
curl "https://nordapi.ee/api/v1/geo/sun?lat=59.9&lon=10.7"
GET /countrydata
获取全球 250 个国家和地区的综合数据,包括官方名称、首都、人口、面积、地区、亚地区、语言、货币、电话代码、顶级域名、边界和国旗信息。完整的地理参考数据集。适用于构建国家选择组件、地理教育工具和参考应用。
curl https://nordapi.ee/api/v1/countrydata
GET /countrydata/search
按名称模糊搜索国家。返回每个匹配国家的完整资料,包括首都、人口、地区、语言和货币。适用于构建自动补全的国家搜索字段和用户可能输入部分或近似国家名称的位置选择器。
q
必填
curl "https://nordapi.ee/api/v1/countrydata/search?q=norway"
GET /countrydata/region/:region
获取特定地理区域内的所有国家(例如欧洲、亚洲、非洲、美洲、大洋洲)。返回该区域内每个国家的完整资料。适用于构建按区域筛选的视图、地理分析工具和按大洲探索世界的教育应用。
region
必填
curl https://nordapi.ee/api/v1/countrydata/region/europe
GET /countrydata/:code
按 ISO 3166-1 alpha-2 代码获取单个国家的完整资料。返回官方名称、首都、人口、面积、语言、货币、电话代码、边界、地区、亚地区等。当只需要一个国家时比获取全部 250 个国家更高效。适用于国家详情页和深度地理内容。
code
必填
curl https://nordapi.ee/api/v1/countrydata/NO
GET /zipcode/:country/:code
在 60+ 个国家中查询邮政编码以获取关联的城市、州/省和地理坐标。在 URL 中提供国家代码和邮政编码。适用于地址验证、在结账表单中自动填充城市和州字段、计算运费区域和映射邮编区域。覆盖美国、加拿大、大部分欧洲和许多其他国家。
country
必填
code
必填
curl https://nordapi.ee/api/v1/zipcode/us/90210
GET /zipcode/reverse
查找给定城市、州和国家的所有邮政编码。邮政编码查询的反向操作——你提供位置并获取匹配的邮政编码。适用于为配送区域映射生成邮编列表、从已知城市名称填充邮编字段和构建地理覆盖分析工具。
country
必填
state
必填
city
必填
curl "https://nordapi.ee/api/v1/zipcode/reverse?country=us&state=CA&city=Beverly+Hills"
GET /marine/current
获取任何沿海或开阔水域位置的当前海洋条件,包括波高、波向、波周期和涌浪数据。需要纬度和经度坐标。对海洋导航应用、冲浪和水上运动规划器、钓鱼工具、海上作业仪表板和海岸安全系统至关重要。数据来自 Open-Meteo 海洋模型。
lat
必填
lon
必填
curl "https://nordapi.ee/api/v1/marine/current?lat=59.9&lon=10.7"
GET /marine/forecast
获取多天海洋天气预报,含逐小时波高、波向、波周期和涌浪预测。最多可配置 7 天。适用于规划航行路线、安排海上作业、安排冲浪时间和构建海洋安全预警系统。数据来自 Open-Meteo 海洋预报模型。
lat
必填
lon
必填
days
可选
默认: 7
curl "https://nordapi.ee/api/v1/marine/forecast?lat=59.9&lon=10.7"
GET /flights/live
从 OpenSky Network ADS-B 数据获取全球当前飞行中飞机的实时位置。返回每架飞机的呼号、出发国家、经度、纬度、高度、速度和航向。可选按地理边界框筛选以追踪特定区域上空的航班。适用于航班追踪应用、航空仪表板、机场附近噪声监测和空中交通模式可视化。
lamin
可选
lomin
可选
lamax
可选
lomax
可选
curl https://nordapi.ee/api/v1/flights/live
GET /tides/stations
列出 NOAA(国家海洋和大气管理局)所有可用的美国沿海潮汐监测站。返回站点 ID、名称和位置。使用此端点查找潮汐预测、水位和温度端点的有效站点 ID。覆盖大西洋、太平洋和墨西哥湾沿岸的美国主要沿海地区。
curl https://nordapi.ee/api/v1/tides/stations
GET /tides/predictions/:station
获取特定 NOAA 潮汐站的预测高潮和低潮时间及高度。返回即将到来的潮汐事件及时间戳和水位。对海岸活动规划、海洋导航、钓鱼应用和海滩出行安排至关重要。提供有效的 NOAA 站点 ID(使用站点端点查找 ID)。
station
必填
curl https://nordapi.ee/api/v1/tides/predictions/9414290
GET /tides/level/:station
获取特定 NOAA 潮汐站的当前实时水位读数。返回最新观测的水位测量值。适用于沿海洪水预警、港口管理、码头调度和将实际水位与预测潮汐进行比较。数据来自近实时更新的 NOAA 实时传感器。
station
必填
curl https://nordapi.ee/api/v1/tides/level/9414290
GET /tides/temperature/:station
获取特定 NOAA 潮汐站的当前水温读数。返回最新观测的海面温度。适用于游泳和水上运动应用、海洋生物监测、钓鱼条件工具和沿海旅游功能。数据来自美国沿海站点的 NOAA 实时温度传感器。
station
必填
curl https://nordapi.ee/api/v1/tides/temperature/9414290
GET /geocoding/search
将地名、地址或位置描述转换为地理坐标(纬度和经度)。返回匹配的位置及其名称、国家、坐标、海拔、人口和时区。支持模糊匹配并返回按相关性排序的多个结果。数据来自基于 GeoNames 数据库的 Open-Meteo 地理编码。对于需要将用户输入的位置转换为坐标以用于天气、地图或其他基于位置的 API 的应用至关重要。
q
必填
count
可选
默认: 10
curl "https://nordapi.ee/api/v1/geocoding/search?q=Oslo"