（→1.使用条款与限制） |
|||
| 第1行： | 第1行： | ||
接口说明 | 接口说明 | ||
| − | ==1.使用条款与限制== | + | == 1.使用条款与限制 == |
| + | |||
使用全景静态图服务前，首先需要登录[http://lbsyun.baidu.com/apiconsole/key API控制台]申请密钥ak，每个ak可每天最多可调用10万次该服务。若您的请求次数超过10万次/天，可发送邮件至mapapi@baidu.com申请配额。 | 使用全景静态图服务前，首先需要登录[http://lbsyun.baidu.com/apiconsole/key API控制台]申请密钥ak，每个ak可每天最多可调用10万次该服务。若您的请求次数超过10万次/天，可发送邮件至mapapi@baidu.com申请配额。 | ||
| − | ==2.使用场景== | + | == 2.使用场景 == |
| + | |||
使用全景静态图接口，可获取图片形式的全景图，并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。 | 使用全景静态图接口，可获取图片形式的全景图，并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。 | ||
| − | ==3.服务参数列表== | + | == 3.服务参数列表 == |
| − | http://api.map.baidu.com/panorama | + | |
| + | [http://api.map.baidu.com/panorama http://api.map.baidu.com/panorama] | ||
{{bluepoint}}组成说明： | {{bluepoint}}组成说明： | ||
| − | {{bluepoint}} | + | {{bluepoint}}域名：[http://api.map.baidu.com http://api.map.baidu.com] |
{{bluepoint}}服务名：panorama | {{bluepoint}}服务名：panorama | ||
| − | ==4.服务参数说明== | + | |
| + | == 4.服务参数说明 == | ||
| + | |||
{| | {| | ||
|- | |- | ||
| − | !参数名 | + | ! 参数名 |
| − | !必选 | + | ! 必选 |
| − | !默认值 | + | ! 默认值 |
| − | !描述 | + | ! 描述 |
|- | |- | ||
| − | |width | + | | width |
| − | |否 | + | | 否 |
| − | |400 | + | | 400 |
| − | |图片宽度，范围[10,4096] | + | | 图片宽度，范围[10,4096] |
|- | |- | ||
| − | |height | + | | height |
| − | |否 | + | | 否 |
| − | |300 | + | | 300 |
| − | |图片高度，范围[10,512] | + | | 图片高度，范围[10,512] |
|- | |- | ||
| − | |location | + | | location |
| − | |是 | + | | 是 |
| − | |无 | + | | 无 |
| − | |全景位置点坐标。坐标格式：lng | + | | 全景位置点坐标。坐标格式：lng<经度>，lat<纬度>，例如116.313393,40.047783。 |
|- | |- | ||
| − | |coordtype | + | | coordtype |
| − | |否 | + | | 否 |
| − | |bd09ll | + | | bd09ll |
| − | |全景位置点的坐标类型，目前支持bd09ll（百度坐标），wgs84ll（GPS坐标） | + | | 全景位置点的坐标类型，目前支持bd09ll（百度坐标），wgs84ll（GPS坐标） |
|- | |- | ||
| − | |panoid | + | | panoid |
| − | |是 | + | | 是 |
| − | |无 | + | | 无 |
| − | |全景图id，与location互斥，即指定location后，无需指定panoId。两者同时设置，以panoId为主。 | + | | 全景图id，与location互斥，即指定location后，无需指定panoId。两者同时设置，以panoId为主。 |
|- | |- | ||
| − | |ak | + | | ak |
| − | |是 | + | | 是 |
| − | |无 | + | | 无 |
| − | |用户的访问密钥 | + | | 用户的访问密钥 |
|- | |- | ||
| − | |sn | + | | sn |
| − | |否 | + | | 否 |
| − | |无 | + | | 无 |
| − | | | + | | 用户的权限签名。 |
|- | |- | ||
| − | |heading | + | | heading |
| − | |否 | + | | 否 |
| − | |0 | + | | 0 |
| − | |水平视角，范围[0,360] | + | | 水平视角，范围[0,360] |
|- | |- | ||
| − | |pitch | + | | pitch |
| − | |否 | + | | 否 |
| − | |0 | + | | 0 |
| − | |垂直视角，范围[0,90]。 | + | | 垂直视角，范围[0,90]。 |
|- | |- | ||
| − | |fov | + | | fov |
| − | |否 | + | | 否 |
| − | |90 | + | | 90 |
| − | |水平方向范围，范围[10,360]，fov=360即可显示整幅全景图 | + | | 水平方向范围，范围[10,360]，fov=360即可显示整幅全景图 |
|} | |} | ||
| − | ==5.返回码说明== | + | == 5.返回码说明 == |
| + | |||
{| | {| | ||
|- | |- | ||
| − | !状态码 | + | ! 状态码 |
| − | !含义 | + | ! 含义 |
|- | |- | ||
| − | |0 | + | | 0 |
| − | |正常 | + | | 正常 |
|- | |- | ||
| − | |507 | + | | 507 |
| − | |coordtype赋值错误，目前只支持bd09ll,wgs84ll | + | | coordtype赋值错误，目前只支持bd09ll,wgs84ll |
|- | |- | ||
| − | |509 | + | | 509 |
| − | | | + | | ak为必选参数，没有加ak时返回错误。 |
|- | |- | ||
| − | |508 | + | | 508 |
| − | |请求ak验证服务失败 | + | | 请求ak验证服务失败 |
|- | |- | ||
| − | |302 | + | | 302 |
| − | |坐标的格式不对，经纬度应该以逗号分隔 | + | | 坐标的格式不对，经纬度应该以逗号分隔 |
|- | |- | ||
| − | |303 | + | | 303 |
| − | |百度经纬度坐标转换为百度墨卡托坐标错误 | + | | 百度经纬度坐标转换为百度墨卡托坐标错误 |
|- | |- | ||
| − | |304 | + | | 304 |
| − | |wgs84经纬度坐标转换为百度墨卡托坐标错误 | + | | wgs84经纬度坐标转换为百度墨卡托坐标错误 |
|- | |- | ||
| − | |402 | + | | 402 |
| − | |请求坐标转panoid服务，返回错误，可能是该点没有panoid | + | | 请求坐标转panoid服务，返回错误，可能是该点没有panoid |
|- | |- | ||
| − | |401 | + | | 401 |
| − | |请求坐标转panoid服务失败 | + | | 请求坐标转panoid服务失败 |
|- | |- | ||
| − | |403 | + | | 403 |
| − | |没有panoid 和 location 参数 | + | | 没有panoid 和 location 参数 |
|- | |- | ||
| − | |501 | + | | 501 |
| − | |超出了width的范围 | + | | 超出了width的范围 |
|- | |- | ||
| − | |502 | + | | 502 |
| − | |超出了height的范围 | + | | 超出了height的范围 |
|- | |- | ||
| − | |503 | + | | 503 |
| − | |超出了heading 的范围 | + | | 超出了heading 的范围 |
|- | |- | ||
| − | |506 | + | | 506 |
| − | |超出了fov的范围 | + | | 超出了fov的范围 |
|- | |- | ||
| − | |601 | + | | 601 |
| − | |请求街景服务失败 | + | | 请求街景服务失败 |
|} | |} | ||
2022年11月14日 (一) 15:54的最后版本
接口说明
1.使用条款与限制
使用全景静态图服务前，首先需要登录API控制台申请密钥ak，每个ak可每天最多可调用10万次该服务。若您的请求次数超过10万次/天，可发送邮件至mapapi@baidu.com申请配额。
2.使用场景
使用全景静态图接口，可获取图片形式的全景图，并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。
3.服务参数列表
http://api.map.baidu.com/panorama
组成说明：
服务名：panorama
4.服务参数说明
| 参数名 | 必选 | 默认值 | 描述 |
|---|---|---|---|
| width | 否 | 400 | 图片宽度，范围[10,4096] |
| height | 否 | 300 | 图片高度，范围[10,512] |
| location | 是 | 无 | 全景位置点坐标。坐标格式：lng<经度>，lat<纬度>，例如116.313393,40.047783。 |
| coordtype | 否 | bd09ll | 全景位置点的坐标类型，目前支持bd09ll（百度坐标），wgs84ll（GPS坐标） |
| panoid | 是 | 无 | 全景图id，与location互斥，即指定location后，无需指定panoId。两者同时设置，以panoId为主。 |
| ak | 是 | 无 | 用户的访问密钥 |
| sn | 否 | 无 | 用户的权限签名。 |
| heading | 否 | 0 | 水平视角，范围[0,360] |
| pitch | 否 | 0 | 垂直视角，范围[0,90]。 |
| fov | 否 | 90 | 水平方向范围，范围[10,360]，fov=360即可显示整幅全景图 |
5.返回码说明
| 状态码 | 含义 |
|---|---|
| 0 | 正常 |
| 507 | coordtype赋值错误，目前只支持bd09ll,wgs84ll |
| 509 | ak为必选参数，没有加ak时返回错误。 |
| 508 | 请求ak验证服务失败 |
| 302 | 坐标的格式不对，经纬度应该以逗号分隔 |
| 303 | 百度经纬度坐标转换为百度墨卡托坐标错误 |
| 304 | wgs84经纬度坐标转换为百度墨卡托坐标错误 |
| 402 | 请求坐标转panoid服务，返回错误，可能是该点没有panoid |
| 401 | 请求坐标转panoid服务失败 |
| 403 | 没有panoid 和 location 参数 |
| 501 | 超出了width的范围 |
| 502 | 超出了height的范围 |
| 503 | 超出了heading 的范围 |
| 506 | 超出了fov的范围 |
| 601 | 请求街景服务失败 |