REST Resource: photo

Zasób: zdjęcie

Zdjęcie służy do przechowywania zdjęć sferycznych wraz z ich 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. Dane wyjściowe tylko podczas tworzenia zdjęcia. Identyfikator zdjęcia, który jest niepowtarzalny wśród wszystkich zdjęć w Google.

uploadReference

object (UploadRef)

Tylko dane wejściowe. Wymagane podczas tworzenia zdjęcia. Tylko dane wejściowe. URL zasobu, do którego przesyłane są bajty zdjęć.

downloadUrl

string

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

thumbnailUrl

string

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

pose

object (Pose)

Opcjonalnie: Pozycja zdjęcia.

connections[]

object (Connection)

Opcjonalnie: Połączenia z innymi zdjęciami. Połączenie oznacza link z tego zdjęcia do innego.

captureTime

string (Timestamp format)

Opcjonalnie: Bezwzględny czas, w którym zrobiono zdjęcie. Jeśli zdjęcie nie ma sygnatury czasowej EXIF, służy do ustawiania sygnatury czasowej w metadanych zdjęcia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

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

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

places[]

object (Place)

Opcjonalnie: Miejsca, w których znajduje się 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. Informacja o tym, czy zdjęcie zostało opublikowane czy odrzucone w Mapach Google.

PhotoId

Identyfikator elementu Photo.

Zapis JSON
{
  "id": string
}
Pola
id

string

Unikalny identyfikator zdjęcia.

UploadRef

Prześlij referencje dotyczące 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 sumy file_source. Wymagane. file_source może mieć tylko jedną z tych wartości:
uploadUrl

string

Każdy użytkownik musi mieć unikalny plik referencyjny do przesłania. Ma on format „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Pozycja

Pomiar nieprzetworzonej pozycji jednostki.

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, jak opisano tutaj: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Jeśli podczas tworzenia elementu Photo nie podano pary szerokości i długości geograficznej, używana jest geolokalizacja z nagłówka EXIF. Para szerokości i długości geograficznej, która nie jest podana w nagłówku zdjęcia lub w nagłówku EXIF, powoduje niepowodzenie przetwarzania zdjęć.

altitude

number

Wysokość pozycji w metrach nad elipsoidą WGS84. NaN wskazuje niezmierzoną ilość.

heading

number

Poniższe parametry pozycji odnoszą się do środka zdjęcia. Są zgodne z https://developers.google.com/streetview/spherical-metadata. Nagłówek kompasu mierzony na środku zdjęcia, wyrażony w stopniach w prawo, od północy. Wartość musi mieścić się w zakresie od 0 do 360. NaN wskazuje niezmierzoną ilość.

pitch

number

Wysokość jest mierzona w stopniach na środku zdjęcia. Wartość musi mieścić się w przedziale od –90 do <= 90. Wartość -90 oznacza patrzenie bezpośrednio w dół, a 90 oznacza patrzenie w górę. NaN wskazuje niezmierzoną ilość.

roll

number

Obrót mierzony w stopniach. Wartość musi mieścić się w zakresie od 0 do 360. Wartość 0 oznacza poziom wzdłuż horyzontu. NaN wskazuje niezmierzoną ilość.

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Czas zapisu GPS od początku epoki UTC.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

level

object (Level)

Poziom (piętro w budynku) używana do konfigurowania nawigacji w pionie.

accuracyMeters

number

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

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest ona wyrażona jako para podwójnej precyzji reprezentująca stopnie szerokości i długości geograficznej. O ile nie wskazano 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 [-90,0, +90,0].

longitude

number

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

Poziom

Informacje o poziomie zawierające numer poziomu i jego nazwę.

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

number

Opcjonalnie: Numer piętra użyty do składania zamówienia. 0 wskazuje poziom gruntu, 1 oznacza pierwszy poziom powyżej gruntu, -1 oznacza pierwszy poziom pod ziemią. Wartości inne niż całkowite są dozwolone.

name

string

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

Połączenie

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

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

object (PhotoId)

Wymagane. Miejsce docelowe połączenia między zdjęciem zawierającym a innym zdjęciem.

Miejsce

Metadane miejsca dotyczące elementu.

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

string

Identyfikator miejsca, jak opisano na stronie https://developers.google.com/places/place-id.

name

string

Tylko dane wyjściowe. Nazwa miejsca zlokalizowana na kod języka languageCode.

languageCode

string

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

TransferStatus

Stan przenoszenia praw.

Wartości w polu enum
TRANSFER_STATUS_UNKNOWN Stan tego przenoszenia jest nieokreślony.
NEVER_TRANSFERRED To zdjęcie nigdy nie było przesyłane.
PENDING Przesyłanie zdjęć zostało rozpoczęte, ale odbiorca jeszcze nie odpowiedział.
COMPLETED Zdjęcia zostały przeniesione i zostało przekazane odbiorcy.
REJECTED Odbiorca odrzucił to przeniesienie zdjęć.
EXPIRED Przesyłanie zdjęć wygasło, zanim odbiorca wykonał jakiekolwiek działania.
CANCELLED Nadawca anulował to przeniesienie zdjęć.
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 zakończy przesyłanie zdjęcia ze zwróconym UploadRef, CreatePhoto publikuje przesłane zdjęcie Photo do Street View w Mapach Google.

delete

Usuwa obiekt Photo i jego metadane.

get

Pobiera metadane określonego elementu Photo.

startUpload

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

update

Aktualizuje metadane elementu Photo, takie jak pozycja, powiązanie miejsca, połączenia itp.