REST Resource: photo

Ресурс: Фото

Photo используется для хранения 360-градусных фотографий вместе с метаданными фотографий.

JSON-представление 
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
Поля
photoId

object ( PhotoId )

Обязательно. Только для вывода. Требуется при обновлении фотографии. Только для вывода при создании фотографии. Идентификатор фотографии, уникальный среди всех фотографий в Google.

uploadReference

object ( UploadRef )

Только ввод. Требуется при создании фотографии. Только ввод. URL-адрес ресурса, куда загружаются байты фотографии.

downloadUrl

string

Только вывод. URL для загрузки байтов фотографии. Это поле заполняется только в том случае, если GetPhotoRequest.view имеет значение PhotoView.INCLUDE_DOWNLOAD_URL .

thumbnailUrl

string

Только вывод. URL-адрес миниатюры для предварительного просмотра заданной фотографии.

pose

object ( Pose )

Необязательно. Поза для фото.

connections[]

object ( Connection )

Необязательно. Связи с другими фотографиями. Связь представляет собой ссылку от этой фотографии к другой фотографии.

captureTime

string ( Timestamp format)

Необязательно. Абсолютное время съёмки фотографии. Если у фотографии нет EXIF-метки времени, эта метка используется для установки метки времени в метаданных фотографии.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

uploadTime

string ( Timestamp format)

Только вывод. Время загрузки изображения.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

places[]

object ( Place )

Необязательно. Места, где это фото уместно.

viewCount

string ( int64 format)

Только вывод. Количество просмотров фотографий.

transferStatus

enum ( TransferStatus )

Только вывод. Статус передачи прав на эту фотографию.

mapsPublishStatus

enum ( MapsPublishStatus )

Только вывод. Статус в Google Картах: опубликовано или отклонено это фото.

Фотоидентификатор

Идентификатор Photo .

JSON-представление 
{
  "id": string
}
Поля
id

string

Уникальный идентификатор фотографии.

UploadRef

Загрузить ссылку на медиа-файлы.

JSON-представление 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
Поля
Поле объединения file_source . Обязательно. file_source может быть только одним из следующих:
uploadUrl

string

Ссылка на загрузку должна быть уникальной для каждого пользователя. Она имеет следующий вид: «https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}».

Поза

Исходное измерение позы объекта.

JSON-представление 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Поля
latLngPair

object ( LatLng )

Пара широты и долготы позы, как описано здесь: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. При создании Photo , если пара широты и долготы не указана, используется геолокация из заголовка EXIF. Отсутствие пары широты и долготы в фотографии или заголовке EXIF ​​приводит к сбою процесса обработки фотографии.

altitude

number

Высота точки над эллипсоидом WGS84 в метрах. NaN обозначает неизмеренную величину.

heading

number

Следующие параметры позы относятся к центру фотографии. Они соответствуют https://developers.google.com/streetview/spherical-metadata . Направление по компасу, измеренное в центре фотографии в градусах по часовой стрелке от севера. Значение должно быть >=0 и <360. NaN указывает на неизмеренную величину.

pitch

number

Угол наклона измеряется в центре фотографии в градусах. Значение должно быть >=-90 и <= 90. Значение -90 означает, что взгляд направлен прямо вниз, а значение 90 — прямо вверх. NaN указывает на неизмеренную величину.

roll

number

Крен, измеряется в градусах. Значение должно быть >= 0 и <360. Значение 0 означает уровень горизонта. NaN указывает на неизмеренную величину.

gpsRecordTimestampUnixEpoch

string ( Timestamp format)

Время записи GPS с момента создания эпохи UTC.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

level

object ( Level )

Уровень (этаж в здании), используемый для настройки вертикальной навигации.

accuracyMeters

number

Расчетная горизонтальная точность этой позы в метрах с достоверностью 68% (одно стандартное отклонение). Например, на Android это значение можно получить с помощью этого метода: https://developer.android.com/reference/android/location/Location#getAccuracy() . На других платформах используются другие методы получения аналогичной оценки точности.

Широта и долгота

Объект, представляющий пару широта/долгота. Выражается в виде пары чисел двойной точности, представляющих градусы широты и долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в нормализованных диапазонах.

JSON-представление 
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Широта в градусах. Должна быть в диапазоне [-90,0, +90,0].

longitude

number

Долгота в градусах. Должна быть в диапазоне [-180,0, +180,0].

Уровень

Информация об уровне, содержащая номер уровня и соответствующее ему название.

JSON-представление 
{
  "number": number,
  "name": string
}
Поля
number

number

Необязательно. Номер этажа, используемый для заказа. 0 обозначает первый этаж, 1 — первый этаж над уровнем земли, -1 — первый этаж под уровнем земли. Допустимы нецелые значения.

name

string

Обязательно. Имя, присвоенное этому уровню, ограничено тремя символами. Подумайте, как были бы обозначены кнопки лифта на этом уровне, если бы там был лифт.

Связь

Связь — это связь исходной фотографии с целевой фотографией.

JSON-представление 
{
  "target": {
    object (PhotoId)
  }
}
Поля
target

object ( PhotoId )

Обязательно. Место назначения соединения между фотографией, содержащей ссылку, и другой фотографией.

Место

Разместить метаданные для сущности.

JSON-представление 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Поля
placeId

string

Идентификатор места, как описано в https://developers.google.com/places/place-id .

name

string

Только вывод. Название места, локализованное в соответствии с кодом языка.

languageCode

string

Только вывод. Код языка, с которым локализовано имя. Это должен быть код языка, указанный в запросе, но может быть и запасным вариантом.

TransferStatus

Статус передачи прав.

Перечисления
TRANSFER_STATUS_UNKNOWN Статус этого перевода не указан.
NEVER_TRANSFERRED Эта фотография никогда не была в передаче.
PENDING Передача фотографий была инициирована, но получатель еще не ответил.
COMPLETED Передача фотографии завершена, и фотография передана получателю.
REJECTED Получатель отклонил данную передачу фотографии.
EXPIRED Срок действия переданной фотографии истек до того, как получатель предпринял какие-либо действия.
CANCELLED Отправитель отменил передачу фотографии.
RECEIVED_VIA_TRANSFER Получатель владеет этой фотографией в связи с передачей прав.

MapsPublishStatus

Статус публикации фотографии в Google Maps.

Перечисления
UNSPECIFIED_MAPS_PUBLISH_STATUS Статус фотографии неизвестен.
PUBLISHED Фотография опубликована для всеобщего обозрения через Google Maps.
REJECTED_UNKNOWN Фотография была отклонена по неизвестной причине.

Методы

create

 После того как клиент завершает загрузку фотографии с возвращенным UploadRef , CreatePhoto публикует загруженную Photo в Street View на Google Maps.

delete

 Удаляет Photo и ее метаданные.

get

 Получает метаданные указанной Photo .

startUpload

 Создает сеанс загрузки для начала загрузки байтов фотографий.

update

 Обновляет метаданные Photo , такие как поза, связь с местом, связи и т. д.