- Ресурс: Фото
- Идентификатор фотографии
- ЗагрузитьСсылка
- Поза
- LatLng
- Уровень
- Связь
- Место
- Статус перевода
- MapsPublishStatus
- Методы
Ресурс: Фото
Photo используется для хранения 360 фотографий вместе с метаданными фотографий.
Представление JSON |
---|
{ "photoId": { object ( |
Поля | |
---|---|
photoId | Необходимый. Только вывод. Требуется при обновлении фото. Вывод только при создании фото. Идентификатор фотографии, уникальный среди всех фотографий в Google. |
uploadReference | Только ввод. Требуется при создании фото. Только ввод. URL-адрес ресурса, на который загружаются байты фотографий. |
downloadUrl | Только вывод. URL-адрес загрузки байтов фотографии. Это поле устанавливается только в том случае, если для |
thumbnailUrl | Только вывод. URL-адрес эскиза для предварительного просмотра данной фотографии. |
shareLink | Только вывод. Поделиться ссылкой на фото. |
pose | Необязательный. Поза фотографии. |
connections[] | Необязательный. Связи с другими фотографиями. Соединение представляет собой ссылку с этой фотографии на другую фотографию. |
captureTime | Необязательный. Абсолютное время, когда была сделана фотография. Если у фотографии нет временной метки exif, она используется для установки временной метки в метаданных фотографии. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
uploadTime | Только вывод. Время загрузки изображения. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
places[] | Необязательный. Места, которым принадлежит это фото. |
viewCount | Только вывод. Количество просмотров фото. |
transferStatus | Только вывод. Статус передачи прав на это фото. |
mapsPublishStatus | Только вывод. Статус в Google Maps, была ли эта фотография опубликована или отклонена. |
Идентификатор фотографии
Идентификатор для 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 | Время записи GPS с эпохи UTC. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
level | Уровень (этаж в здании) используется для настройки вертикальной навигации. |
accuracyMeters | Предполагаемая горизонтальная точность этой позы в метрах с достоверностью 68% (одно стандартное отклонение). Например, на 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, с которым локализовано имя. Это должен быть код языка, указанный в запросе, но это может быть запасной вариант. |
Статус перевода
Статус передачи прав.
перечисления | |
---|---|
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 | Фотография была отклонена по неизвестной причине. |
Методы | |
---|---|
| После того, как клиент завершит загрузку фотографии с возвращенным UploadRef , CreatePhoto публикует загруженную Photo в Просмотр улиц на Картах Google. |
| Удаляет Photo и ее метаданные. |
| Получает метаданные указанного Photo . |
| Создает сеанс загрузки, чтобы начать загрузку байтов фотографий. |
| Обновляет метаданные Photo , такие как поза, ассоциация места, связи и т. д. |