REST Resource: photo

Zasób: Photo

Zdjęcia służą do przechowywania zdjęć sferycznych wraz z metadanymi.

Zapis 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)
}
Pola
photoId

object (PhotoId)

Wymagane. Tylko dane wyjściowe. Wymagane podczas aktualizowania zdjęcia. Tylko dane wyjściowe podczas tworzenia zdjęcia. Identyfikator zdjęcia, który jest unikalny wśród wszystkich zdjęć w Google.
uploadReference

object (UploadRef)

Tylko dane wejściowe. Wymagane podczas tworzenia zdjęcia. Tylko dane wejściowe. Adres URL zasobu, na który przesyłane są bajty zdjęcia.
downloadUrl

string

Tylko dane wyjściowe. Adres URL pobierania bajtów zdjęcia. To pole jest ustawiane tylko wtedy, gdy GetPhotoRequest.view ma wartość PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

Tylko dane wyjściowe. URL miniatury do wyświetlania podglądu danego zdjęcia.
pose

object (Pose)

Opcjonalnie: Poza na zdjęciu.
connections[]

object (Connection)

Opcjonalnie: połączenia z innymi zdjęciami; Połączenie to link od tego zdjęcia do innego.
captureTime

string (Timestamp format)

Opcjonalnie: Dokładny czas, w którym zostało zrobione zdjęcie. Jeśli zdjęcie nie ma sygnatury czasowej EXIF, ta wartość jest używana do ustawienia sygnatury czasowej w metadanych zdjęcia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

Tylko dane wyjściowe. Czas przesłania obrazu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
places[]

object (Place)

Opcjonalnie: Miejsca, do których należy to zdjęcie.
viewCount

string (int64 format)

Tylko dane wyjściowe. Liczba wyświetleń zdjęcia.
transferStatus

enum (TransferStatus)

Tylko dane wyjściowe. Stan przeniesienia praw do tego zdjęcia.
mapsPublishStatus

enum (MapsPublishStatus)

Tylko dane wyjściowe. Stan w Mapach Google, czyli czy zdjęcie zostało opublikowane, czy odrzucone.

PhotoId

Identyfikator Photo.

Zapis JSON 
{
  "id": string
}
Pola
id

string

Unikalny identyfikator zdjęcia.

UploadRef

Prześlij plik referencyjny dla plików multimedialnych.

Zapis 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.
}
Pola
Pole zbiorcze file_source. Wymagane. file_source może mieć tylko jedną z tych wartości:
uploadUrl

string

Referencja przesyłania powinna być unikalna dla każdego użytkownika. Ma on format: „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}”

Poza

Surowe pomiary pozycji dla elementu.

Zapis JSON 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Pola
latLngPair

object (LatLng)

Para szerokości i długości geograficznej pozycji, zgodnie z opisem tutaj: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Podczas tworzenia elementu Photo, jeśli nie podasz pary szerokości i długości geograficznej, użyjemy geolokalizacji z nagłówka EXIF. Jeśli w zdjęciu lub nagłówku EXIF nie ma pary współrzędnych geograficznych, przetwarzanie zdjęcia zakończy się niepowodzeniem.
altitude

number

Wysokość pozycji w metrach nad elipsoidą WGS84. NaN oznacza niezmierzony rozmiar.
heading

number

Poniższe parametry dotyczące pozycji odnoszą się do środka zdjęcia. Są one zgodne z informacjami na stronie https://developers.google.com/streetview/spherical-metadata. Kierunek kompasu mierzony w stopniach od północy zgodnie z ruchem wskazówek zegara w środku zdjęcia. Wartość musi być większa lub równa 0 i mniejsza niż 360. NaN oznacza niezmierzony rozmiar.
pitch

number

Pochylenie mierzone w środku zdjęcia w stopniach. Wartość musi być większa lub równa -90 i mniejsza lub równa 90. Wartość -90 oznacza patrzenie bezpośrednio w dół, a wartość 90 – patrzenie bezpośrednio w górę. NaN oznacza niezmierzony rozmiar.
roll

number

Przechył mierzony w stopniach. Wartość musi być większa lub równa 0 i mniejsza niż 360. Wartość 0 oznacza poziom horyzontu. NaN oznacza niezmierzony rozmiar.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Czas rekordu GPS od początku epoki UTC.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
level

object (Level)

Poziom (piętro w budynku) używany do konfigurowania nawigacji pionowej.
accuracyMeters

number

Szacowana dokładność pozioma tej pozycji w metrach z poziomem ufności 68% (jedno odchylenie standardowe). Na przykład na Androidzie ta wartość jest dostępna w tej metodzie: https://developer.android.com/reference/android/location/Location#getAccuracy(). Inne platformy mają różne metody uzyskiwania podobnych oszacowań dokładności.

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest to para liczb zmiennoprzecinkowych podwójnej precyzji, które reprezentują stopnie szerokości i długości geograficznej. O ile nie określono inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych zakresach.

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [–180,0, +180,0].

Poziom

Informacje o poziomie, w tym numer poziomu i jego nazwa.

Zapis JSON 
{
  "number": number,
  "name": string
}
Pola
number

number

Opcjonalnie: Numer piętra używany do zamawiania. 0 oznacza poziom gruntu, 1 – pierwszy poziom nad poziomem gruntu, a -1 – pierwszy poziom pod poziomem gruntu. Dozwolone są wartości niecałkowite.
name

string

Wymagane. Nazwa przypisana do tego poziomu, ograniczona do 3 znaków. Zastanów się, jak byłyby oznaczone przyciski windy na tym poziomie, gdyby była winda.

Połączenie

Połączenie to link od zdjęcia źródłowego do zdjęcia docelowego.

Zapis JSON 
{
  "target": {
    object (PhotoId)
  }
}
Pola
target

object (PhotoId)

Wymagane. Miejsce docelowe połączenia ze zdjęcia zawierającego do innego zdjęcia.

Miejsce

Metadane miejsca dla jednostki.

Zapis JSON 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Pola
placeId

string

Identyfikator miejsca zgodnie z opisem na stronie https://developers.google.com/places/place-id.
name

string

Tylko dane wyjściowe. Nazwa miejsca zlokalizowana w języku określonym przez languageCode.
languageCode

string

Tylko dane wyjściowe. Kod języka, w którym nazwa jest zlokalizowana. Powinien to być kod języka określony w żądaniu, ale może to być język zastępczy.

TransferStatus

Stan przeniesienia praw.

Wartości w polu enum
TRANSFER_STATUS_UNKNOWN Stan tego przenoszenia jest nieokreślony.
NEVER_TRANSFERRED To zdjęcie nigdy nie było częścią transferu.
PENDING Przesyłanie zdjęć zostało zainicjowane, ale odbiorca jeszcze nie odpowiedział.
COMPLETED Przenoszenie zdjęcia zostało zakończone i zostało ono przekazane odbiorcy.
REJECTED Adresat odrzucił przeniesienie tego zdjęcia.
EXPIRED Przesyłanie zdjęć wygasło, zanim odbiorca wykonał jakiekolwiek działanie.
CANCELLED Nadawca anulował przenoszenie tego zdjęcia.
RECEIVED_VIA_TRANSFER Odbiorca jest właścicielem tego zdjęcia ze względu na przeniesienie praw.

MapsPublishStatus

Stan publikacji zdjęcia w Mapach Google.

Wartości w polu enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Stan zdjęcia jest nieznany.
PUBLISHED Zdjęcie jest publikowane publicznie w Mapach Google.
REJECTED_UNKNOWN Zdjęcie zostało odrzucone z nieznanego powodu.

Metody

create

 Gdy klient skończy przesyłać zdjęcie z użyciem zwróconego parametru UploadRef, CreatePhoto publikuje przesłany parametr Photo w Street View w Mapach Google.

delete

 Usuwa Photo i powiązane z nim metadane.

get

 Pobiera metadane określonego Photo.

startUpload

 Tworzy sesję przesyłania, aby rozpocząć przesyłanie bajtów zdjęcia.

update

 Aktualizuje metadane Photo, takie jak pozycja, powiązanie z miejscem, połączenia itp.