按地点名称显示坐标
1.1 简要描述
通过输入国家名称、州、市、省、县地名来获取对应坐标。
1.2 请求URL
http://api.openweathermap.org/geo/1.0/direct
1.3 请求方式
POST
1.4 入参
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
q |
string |
|
是 |
城市名称、州代码(仅适用于美国)和国家/地区代码,以逗号分隔。请使用 |
appid |
string |
|
是 |
您唯一的 |
limit |
string |
|
是 |
API响应中的位置数量(API响应中最多可以返回5个结果) |
1.5 出参
参数名 |
参数类型 |
默认值 |
描述 |
name |
String |
|
找到的位置的名称 |
local_names.[language |
String |
|
code] |
local_names.ascii |
String |
|
用于提供地点名称的 |
local_names.feature_name |
String |
|
被解析地点的特征名称或地标 |
lat |
String |
|
找到位置的地理坐标(纬度) |
lon |
String |
|
找到位置的地理坐标(经度) |
country |
String |
|
发现位置的国家/地区 |
state |
String |
|
(如果有的话)所发现位置的状态 |
1.6 错误码
错误码 |
错误信息 |
描述 |
400 |
错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 |
|
401 |
未经授权。如果请求中未提供 |
|
404 |
如果服务数据库中不存在请求参数( |
|
429 |
请求过多。如果超出了向此 |
|
5xx |
意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 |
|
1.7 示例
请求参数{
"q": "",
"appid": "",
"limit": ""
}
返回参数
{
"name": "",
"local_names.[language": "",
"local_names.ascii": "",
"local_names.feature_name": "",
"lat": "",
"lon": "",
"country": "",
"state": ""
}
错误码
{
"400": "错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到",
"401": "未经授权。如果请求中未提供",
"404": "如果服务数据库中不存在请求参数(",
"429": "请求过多。如果超出了向此",
"5xx": "意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的"
}
通过邮政编码来获取地理坐标
2.1 简要描述
通过解析邮政编码获取对应的地理坐标
2.2 请求URL
http://api.openweathermap.org/geo/1.0/zip
2.3 请求方式
POST
2.4 入参
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
zip |
string |
|
是 |
邮政编码和国家/地区代码以逗号分隔。请使用 |
appid |
string |
|
是 |
您唯一的 |
2.5 出参
参数名 |
参数类型 |
默认值 |
描述 |
zipAPI |
string |
|
请求中指定的邮政编码 |
name |
string |
|
发现的区域名称 |
lat |
string |
|
找到的邮政编码质心的地理坐标(纬度) |
lon |
string |
|
找到的邮政编码质心的地理坐标(经度) |
country |
string |
|
找到的邮政编码所在的国家/地区 |
2.6 错误码
错误码 |
错误信息 |
描述 |
400 |
错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 |
|
401 |
未经授权。如果请求中未提供 |
|
404 |
如果服务数据库中不存在请求参数( |
|
429 |
请求过多。如果超出了向此 |
|
5xx |
意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 |
|
2.7 示例
请求参数{
"zip": "",
"appid": ""
}
返回参数
{
"zipAPI": "",
"name": "",
"lat": "",
"lon": "",
"country": ""
}
错误码
{
"400": "错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到",
"401": "未经授权。如果请求中未提供",
"404": "如果服务数据库中不存在请求参数(",
"429": "请求过多。如果超出了向此",
"5xx": "意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的"
}
反向地理编码
3.1 简要描述
通过经纬度获取对应的地点名称
3.2 请求URL
http://api.openweathermap.org/geo/1.0/reverse
3.3 请求方式
POST
3.4 入参
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
lat |
string |
|
是 |
地理坐标(纬度) |
lon |
string |
|
是 |
地理坐标(经度) |
appid |
string |
|
是 |
您唯一的 |
limit |
string |
|
是 |
API响应中的位置名称数量(API响应中可以返回多个结果) |
3.5 出参
参数名 |
参数类型 |
默认值 |
描述 |
name |
string |
|
找到的位置的名称 |
local_names.[language code] |
String |
|
string |
local_names.ascii |
string |
|
用于提供地点名称的 |
local_names.feature_name |
string |
|
被解析地点的特征名称或地标 |
lat |
string |
|
找到位置的地理坐标(纬度) |
lon |
string |
|
找到位置的地理坐标(经度) |
country |
string |
|
发现位置的国家/地区 |
state |
string |
|
(如果有的话)所发现位置的状态 |
3.6 错误码
错误码 |
错误信息 |
描述 |
400 |
错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 |
|
401 |
未经授权。如果请求中未提供 |
|
404 |
如果服务数据库中不存在请求参数( |
|
429 |
请求过多。如果超出了向此 |
|
5xx |
意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 |
|
3.7 示例
请求参数{
"lat": "",
"lon": "",
"appid": "",
"limit": ""
}
返回参数
{
"name": "",
"local_names.[language code]": "",
"local_names.ascii": "",
"local_names.feature_name": "",
"lat": "",
"lon": "",
"country": "",
"state": ""
}
错误码
{
"400": "错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到",
"401": "未经授权。如果请求中未提供",
"404": "如果服务数据库中不存在请求参数(",
"429": "请求过多。如果超出了向此",
"5xx": "意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的"
}