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

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

uploadTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "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 Maps, была ли эта фотография опубликована или отклонена.

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

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

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

string

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

ЗагрузитьСсылка

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

Представление 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 "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "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() . Другие платформы имеют другие методы получения аналогичных оценок точности.

LatLng

Объект, представляющий пару широта/долгота. Это выражается в виде пары двойных чисел, представляющих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту 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

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

Связь

Соединение — это ссылка от исходной фотографии к фотографии назначения.

Представление 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.

languageCode

string

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

Статус перевода

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

перечисления
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 в Просмотр улиц на Картах Google.

delete

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

get

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

startUpload

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

update

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