- Zasób: Zdjęcie
- PhotoId
- Prześlij odwołanie
- Poza
- LatLng
- Poziom
- Połączenie
- Miejsce
- Stan transferu
- Stan publikacji w Mapach Google
- Metody
Zasób: zdjęcie
Zdjęcia służą do przechowywania zdjęć sferycznych i ich metadanych.
Zapis JSON |
---|
{ "photoId": { object ( |
Pola | |
---|---|
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 |
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 |
Tylko dane wyjściowe. Adres URL pobierania bajtów zdjęć. To pole jest ustawione tylko wtedy, gdy |
thumbnailUrl |
Tylko dane wyjściowe. Adres URL miniatury przedstawiającej podgląd danego zdjęcia. |
shareLink |
Tylko dane wyjściowe. Link do udostępniania zdjęcia. |
pose |
Opcjonalnie. Zdjęcie. |
connections[] |
Opcjonalnie. Połączenia z innymi zdjęciami. Połączenie reprezentuje link między tym zdjęciem a innym zdjęciem. |
captureTime |
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: |
uploadTime |
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: |
places[] |
Opcjonalnie. Miejsca, w których znajduje się to zdjęcie. |
viewCount |
Tylko dane wyjściowe. Wyświetlać liczbę zdjęć. |
transferStatus |
Tylko dane wyjściowe. Stan przenoszenia praw do tego zdjęcia. |
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 |
Niepowtarzalny identyfikator zdjęcia. |
Prześlij odwołanie
Prześlij odniesienie do plików multimedialnych.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy file_source . Wymagany. file_source może mieć tylko jedną z tych wartości: |
|
uploadUrl |
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 ( |
Pola | |
---|---|
latLngPair |
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. |
altitude |
Wysokość położenia w metrach powyżej elipsoidy WGS84. NaN wskazuje ilość niemierzoną. |
heading |
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 |
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 |
Obrót w stopniach. Wartość musi być >= 0 i <360. Wartość 0 oznacza poziom z horyzontem. NaN wskazuje ilość niemierzoną. |
gpsRecordTimestampUnixEpoch |
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: |
level |
Poziom (piętro w budynku) używany do konfigurowania nawigacji pionowej. |
accuracyMeters |
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 |
Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0]. |
longitude |
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 |
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 |
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 ( |
Pola | |
---|---|
target |
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 |
Identyfikator miejsca podany na https://developers.google.com/places/place-id. |
name |
Tylko dane wyjściowe. Nazwa miejsca przetłumaczonego na język languageCode. |
languageCode |
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 |
|
---|---|
|
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. |
|
Usuwa Photo i jej metadane. |
|
Pobiera metadane określonego elementu Photo . |
|
Tworzy sesję przesyłania, aby rozpocząć przesyłanie bajtów zdjęć. |
|
Aktualizuje metadane Photo , takie jak pozycja, powiązanie miejsca, połączenia itp. |