资源:照片
照片用于存储 360 度全景照片以及照片元数据。
JSON 表示法 |
---|
{ "photoId": { object ( |
字段 | |
---|---|
photoId |
必需。仅供输出。更新照片时必须指定这项设置。仅在创建照片时输出。照片的标识符,在 Google 的所有照片中都是唯一的。 |
uploadReference |
仅限输入。创建照片时必填。仅限输入。照片字节上传到的资源网址。 |
downloadUrl |
仅供输出。照片字节的下载网址。只有在 |
thumbnailUrl |
仅供输出。显示给定照片预览的缩略图网址。 |
shareLink |
仅供输出。照片的分享链接。 |
pose |
可选。照片照片。 |
connections[] |
可选。连接到其他照片。连接表示此照片与另一张照片之间的关联。 |
captureTime |
可选。照片的绝对时间。当照片没有 Exif 时间戳时,这用于设置照片元数据中的时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
uploadTime |
仅供输出。图片上传的时间。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
places[] |
可选。此照片所属的地点。 |
viewCount |
仅供输出。查看照片的数量。 |
transferStatus |
仅供输出。此照片的权利转移状态。 |
mapsPublishStatus |
仅供输出。Google 地图中的状态:此照片是已发布还是已被拒绝。 |
照片 ID
Photo
的标识符。
JSON 表示法 |
---|
{ "id": string } |
字段 | |
---|---|
id |
照片的唯一标识符。 |
上传参考
媒体文件的上传参考信息。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 file_source 。必需。file_source 只能是下列其中一项: |
|
uploadUrl |
每位用户的上传引用都应该是唯一的。其格式为:“https://StreetViewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}” |
姿势
实体的原始姿态测量。
JSON 表示法 |
---|
{ "latLngPair": { object ( |
字段 | |
---|---|
latLngPair |
姿势的纬度和经度对,如下所述:https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng 创建 |
altitude |
姿势高度(以米为单位,高于 WGS84 椭球体)。NaN 表示未衡量的数量。 |
heading |
以下位置参数与照片的中心相关。需与 https://developers.google.com/streetview/spherical-metadata 一致。罗盘航向,在照片中心测量,以与北方所呈顺时针角度表示。值必须大于等于 0 且小于 360。NaN 表示未衡量的数量。 |
pitch |
俯仰角,以照片中心为基准(以度为单位)。值必须大于等于 90 且小于等于 90。值 -90 表示直接俯视,值 90 表示直接向上看。NaN 表示未衡量的数量。 |
roll |
滚动,以度为单位。值必须大于等于 0 且小于 360。值为 0 表示地平线。NaN 表示未衡量的数量。 |
gpsRecordTimestampUnixEpoch |
自世界协调时间 (UTC) 纪元起的 GPS 记录的时间。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
level |
用于配置垂直导航的楼层(建筑物内的楼层)。 |
accuracyMeters |
此姿势的水平精度估算值,以米为单位,置信度为 68%(1 个标准偏差)。例如,在 Android 上,可通过 https://developer.android.com/reference/android/location/Location#getAccuracy() 方法获取此值。其他平台可通过不同的方法获取类似的准确度估值。 |
LatLng
表示纬度/经度对的对象。该对象以一对双精度数表示,分别代表纬度度数和经度度数。除非另有说明,否则该对象必须符合 WGS84 标准。值必须介于标准化范围内。
JSON 表示法 |
---|
{ "latitude": number, "longitude": number } |
字段 | |
---|---|
latitude |
纬度(以度为单位)。它必须在 [-90.0, +90.0] 范围内。 |
longitude |
经度(以度为单位)。它必须在 [-180.0, +180.0] 范围内。 |
等级
包含层级编号及其对应名称的层级信息。
JSON 表示法 |
---|
{ "number": number, "name": string } |
字段 | |
---|---|
number |
可选。楼层编号,用于订购。0 表示地面,1 表示高于地面的第一级,-1 表示低于地面的第一级。可以使用非整数值。 |
name |
必需。为该级别指定的名称,不得超过 3 个字符。并考虑在存在电梯时,应如何标记此级别的电梯按钮。 |
连接
连接是指从源照片到目标照片的链接。
JSON 表示法 |
---|
{
"target": {
object ( |
字段 | |
---|---|
target |
必需。从包含照片到另一张照片的连接目标。 |
地点
为实体添加元数据。
JSON 表示法 |
---|
{ "placeId": string, "name": string, "languageCode": string } |
字段 | |
---|---|
placeId |
地点标识符,如 https://developers.google.com/places/place-id 中所述。 |
name |
仅供输出。地点的名称,已本地化为 languageCode。 |
languageCode |
仅供输出。名称经过本地化的 languageCode。它应该是请求中指定的 languageCode,但可以是回退机制。 |
传输状态
权利转让的状态。
枚举 | |
---|---|
TRANSFER_STATUS_UNKNOWN |
此转移的状态未指定。 |
NEVER_TRANSFERRED |
这张照片从未传输过。 |
PENDING |
此照片转移流程已发起,但对方尚未回复。 |
COMPLETED |
照片转移已完成,并且照片已转移给接收者。 |
REJECTED |
收款人拒绝了这张照片转移。 |
EXPIRED |
照片转移在收件人执行任何操作之前已过期。 |
CANCELLED |
发送者已取消此照片转移。 |
RECEIVED_VIA_TRANSFER |
由于权利转移,接收者拥有此照片。 |
地图发布状态
照片在 Google 地图上的发布状态。
枚举 | |
---|---|
UNSPECIFIED_MAPS_PUBLISH_STATUS |
照片状态未知。 |
PUBLISHED |
照片会通过 Google 地图向公众发布。 |
REJECTED_UNKNOWN |
照片因未知原因而遭到拒绝。 |
方法 |
|
---|---|
|
客户端上传完返回的 UploadRef 照片后,CreatePhoto 会将上传的 Photo 发布到 Google 地图上的街景。 |
|
删除 Photo 及其元数据。 |
|
获取指定 Photo 的元数据。 |
|
创建上传会话以开始上传照片字节。 |
|
更新 Photo 的元数据,例如位置方向、地点关联、连接等。 |