REST Resource: photo

Zasób: zdjęcie

Zdjęcia służą do przechowywania zdjęć sferycznych i ich metadanych.

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)

Wymagany. Tylko dane wyjściowe. Wymagane podczas aktualizowania zdjęcia. Dane wyjściowe są tworzone tylko podczas tworzenia zdjęcia. Niepowtarzalny identyfikator zdjęcia na wszystkich zdjęciach w Google.
uploadReference

object (UploadRef)

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

string

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

string

Tylko dane wyjściowe. Adres URL miniatury przedstawiającej podgląd danego zdjęcia.
pose

object (Pose)

Opcjonalnie. Zdjęcie.
connections[]

object (Connection)

Opcjonalnie. Połączenia z innymi zdjęciami. Połączenie reprezentuje link między tym zdjęciem a innym zdjęciem.
captureTime

string (Timestamp format)

Opcjonalnie. Całkowity czas wykonania zdjęcia. Jeśli zdjęcie nie ma sygnatury czasowej, używa się go do ustawiania sygnatury czasowej w metadanych zdjęcia.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie dziewięcioma cyframi. 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 formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie dziewięcioma cyframi. 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. Wyświetlać liczbę zdjęć.
transferStatus

enum (TransferStatus)

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

enum (MapsPublishStatus)

Tylko dane wyjściowe. Stan w Mapach Google, bez względu na to, czy zdjęcie zostało opublikowane czy odrzucone.

Identyfikator zdjęcia

Identyfikator elementu Photo.

Zapis JSON 
{
  "id": string
}
Pola
id

string

Niepowtarzalny identyfikator zdjęcia.

Prześlij odwołanie

Prześlij odniesienie do 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. Wymagany. file_source może mieć tylko jedną z tych wartości:
uploadUrl

string

Plik referencyjny powinien być unikalny dla każdego użytkownika. Ma on następujący format: „https://streetviewpublish.googleapis.com/media/user/{identyfikator_konta}/photo/{uploadReference}”

Pozycja

Nieprzetworzony pomiar pozycji.

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

object (LatLng)

Długość i szerokość geograficzna pozycji w pozycji zgodnej z tym opisem: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Jeśli nie podasz pary szerokości i długości geograficznej, użyjemy geolokalizacji z nagłówka Exif.Photo Jeśli w nagłówku zdjęcia lub Exif nie podano pary szerokości i długości geograficznej, przetwarzanie zdjęcia zakończy się niepowodzeniem.
altitude

number

Wysokość położenia w metrach powyżej elipsoidy WGS84. NaN wskazuje ilość niemierzoną.
heading

number

Te parametry pozycji odnoszą się do środka zdjęcia. Są one zgodne z danymi https://developers.google.com/streetview/spherical-metadata. Nagłówek kompasu, mierzony w środku zdjęcia w stopniach w prawo, od północy. Wartość musi być >=0 i <360. NaN wskazuje ilość niemierzoną.
pitch

number

Ton mierzony w środku zdjęcia w stopniach. Wartości muszą być z zakresu >=-90 i <= 90. Wartość -90 oznacza, że spojrzysz w dół, a wartość 90 oznacza bezpośrednie spojrzenie w górę. NaN wskazuje ilość niemierzoną.
roll

number

Obrót w stopniach. Wartość musi być >= 0 i <360. Wartość 0 oznacza poziom z horyzontem. NaN wskazuje ilość niemierzoną.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Czas zapisu GPS od początku strefy czasowej UTC.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie dziewięcioma cyframi. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
level

object (Level)

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

number

Szacunkowa dokładność tej pozycji w metrach z ufnością 68% (jedno odchylenie standardowe). Na przykład na urządzeniu z Androidem ta wartość jest dostępna w ten sposób: https://developer.android.com/reference/android/location/Location#getAccuracy(). Inne platformy mogą korzystać z różnych metod uzyskiwania podobnych dokładności.

Długość geograficzna

Obiekt reprezentujący szerokość i długość geograficzną. Wartość ta jest wyrażona jako 2-krotność liczby szerokości i długości geograficznej (w stopniach). O ile nie wskazano inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą się mieścić w normowanych 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 [-180,0, +180,0].

Poziom

Informacje o poziomie zawierające numer poziomu i odpowiadającą mu nazwę.

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

number

Opcjonalnie. Numer piętra używany do zamawiania. 0 oznacza poziom gruntu, 1 oznacza pierwszy poziom nad ziemią, -1 oznacza pierwszy poziom pod ziemią. Wartości nieliczbowe są prawidłowe.
name

string

Wymagany. Nazwa przypisana do tego poziomu, ograniczona do 3 znaków. Zastanów się, jak wyglądałyby etykiety przycisków windy na tym poziomie, gdyby była podniesiona winda.

Połączenie

Połączenie to link między zdjęciem źródłowym a zdjęciem docelowym.

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

object (PhotoId)

Wymagany. Miejsce docelowe połączenia ze zdjęciem, które zawiera inne zdjęcie.

Miejsce

Metadane metadanych elementu.

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

string

Identyfikator miejsca podany na https://developers.google.com/places/place-id.
name

string

Tylko dane wyjściowe. Nazwa miejsca przetłumaczonego na język languageCode.
languageCode

string

Tylko dane wyjściowe. Język languageCode, z którego jest zlokalizowana nazwa. Powinien to być parametr languageCode podany w żądaniu, ale może on być wartością zastępczą.

Stan transferu

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 przenoszone.
PENDING Przenoszenie zdjęcia zostało zainicjowane, ale odbiorca jeszcze nie odpowiedział.
COMPLETED Przenoszenie zdjęć zostało zakończone. Zdjęcie zostało przeniesione do adresata.
REJECTED Odbiorca odrzucił to przeniesienie zdjęcia.
EXPIRED Przenoszenie zdjęcia zakończyło się, zanim odbiorca podjął jakiekolwiek działania.
CANCELLED Nadawca anulował to przeniesienie zdjęcia.
RECEIVED_VIA_TRANSFER Odbiorca jest właścicielem tego zdjęcia ze względu na przeniesienie praw.

Stan publikacji Map

Stan publikacji zdjęcia w Mapach Google.

Wartości w polu enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Stan zdjęcia jest nieznany.
PUBLISHED Zdjęcie zostanie opublikowane 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 urządzeniem UploadRef, CreatePhoto opublikuje przesłane zdjęcie Photo w Street View w Mapach Google.

delete

 Usuwa Photo i jej metadane.

get

 Pobiera metadane określonego elementu Photo.

startUpload

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

update

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