REST Resource: photo

Ресурс: Фото

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

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, она используется для установки метки времени в метаданных фотографии.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

uploadTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

places[]

object ( Place )

Необязательный. Места, которым принадлежит это фото.

viewCount

string ( int64 format)

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

transferStatus

enum ( TransferStatus )

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

mapsPublishStatus

enum ( MapsPublishStatus )

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

Идентификатор фотографии

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

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

string

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

ЗагрузитьRef

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

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.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

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

Статус трансфера

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

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

КартыОпубликоватьСтатус

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

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

Методы

create

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

delete

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

get

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

startUpload

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

update

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