REST Resource: photo

Kaynak: Fotoğraf

Fotoğraf, fotoğraf meta verileriyle birlikte 360° fotoğrafları depolamak için kullanılır.

JSON gösterimi 
{
  "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)
}
Alanlar
photoId

object (PhotoId)

Zorunlu. Yalnızca çıkış. Fotoğraf güncellenirken gerekli. Yalnızca fotoğraf oluşturulurken çıkış yapılır. Google'daki tüm fotoğraflarda benzersiz olan fotoğraf tanımlayıcısı.
uploadReference

object (UploadRef)

Yalnızca giriş. Fotoğraf oluştururken gereklidir. Yalnızca giriş. Fotoğraf baytlarının yüklendiği kaynak URL'si.
downloadUrl

string

Yalnızca çıkış. Fotoğraf baytlarının indirme URL'si. Bu alan yalnızca GetPhotoRequest.view, PhotoView.INCLUDE_DOWNLOAD_URL olarak ayarlandığında ayarlanır.
thumbnailUrl

string

Yalnızca çıkış. İlgili fotoğrafın önizlemesini gösteren küçük resim URL'si.
pose

object (Pose)

İsteğe bağlı. Fotoğrafın konumu.
connections[]

object (Connection)

İsteğe bağlı. Diğer fotoğraflara bağlantılar Bağlantı, bu fotoğraftan başka bir fotoğrafa olan bağlantıyı temsil eder.
captureTime

string (Timestamp format)

İsteğe bağlı. Fotoğrafın çekildiği mutlak zaman. Fotoğrafın exif zaman damgası yoksa bu, fotoğraf meta verilerinde bir zaman damgası ayarlamak için kullanılır.

Nanosaniye çözünürlüğüne ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

Yalnızca çıkış. Resmin yüklendiği zaman.

Nanosaniye çözünürlüğüne ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
places[]

object (Place)

İsteğe bağlı. Bu fotoğrafın ait olduğu yerler.
viewCount

string (int64 format)

Yalnızca çıkış. Fotoğrafın görüntülenme sayısı.
transferStatus

enum (TransferStatus)

Yalnızca çıkış. Bu fotoğrafta hakların aktarımı.
mapsPublishStatus

enum (MapsPublishStatus)

Yalnızca çıkış. Google Haritalar'daki durum (bu fotoğrafın yayınlanmış veya reddedilmiş olma durumu).

Fotoğraflı Kimlik

Bir Photo tanımlayıcısı.

JSON gösterimi 
{
  "id": string
}
Alanlar
id

string

Fotoğrafın benzersiz tanımlayıcısı.

YüklemeReferansı

Medya dosyaları için referans yükleyin.

JSON gösterimi 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
Alanlar
Birlik alanı file_source. Zorunlu. file_source aşağıdakilerden yalnızca biri olabilir:
uploadUrl

string

Yükleme referansı, her kullanıcı için benzersiz olmalıdır. Şu biçimdedir: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Poz

Bir tüzel kişi için işlenmemiş poz ölçümü.

JSON gösterimi 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Alanlar
latLngPair

object (LatLng)

Pozisyonun şu şekilde açıklandığı gibi boylam ve boylam çifti: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Photo oluşturulurken enlem ve boylam çifti sağlanmazsa exif üstbilgisindeki coğrafi konum kullanılır. Fotoğraf veya exif başlığında sağlanmayan enlem ve boylam çifti, fotoğraf işleminin başarısız olmasına neden olur.
altitude

number

Pozların WGS84 elipsoidin üzerindeki metre cinsinden yüksekliği. NaN ölçülmeyen miktarı gösterir.
heading

number

Aşağıdaki pozlama parametreleri fotoğrafın ortasıyla ilgilidir. Bunlar, https://developers.google.com/streetview/spherical-metadata ile eşleşir. Fotoğrafın ortasında kuzeyden saat yönünde ölçülen pusula başlığı. Değer >=0 ve <360 olmalıdır. NaN ölçülmeyen miktarı gösterir.
pitch

number

Fotoğrafın ortasında derece cinsinden ölçülen perde. Değer >=-90 ve <= 90 olmalıdır. -90 değeri, doğrudan aşağı bakınca 90 değeri ise doğrudan yukarıya işaret eder. NaN ölçülmeyen miktarı gösterir.
roll

number

Derece cinsinden ölçülen rulo. Değer >= 0 ve <360 olmalıdır. 0 değeri, ufuk hizasında seviyeler anlamına gelir. NaN ölçülmeyen miktarı gösterir.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

UTC döneminden sonra GPS kaydının zamanı.

Nanosaniye çözünürlüğüne ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
level

object (Level)

Dikey gezinmeyi yapılandırmak için kullanılan düzey (bir binadaki kat).
accuracyMeters

number

Bu pozun% 68 güvenle (bir standart sapma) metre cinsinden tahmini yatay doğruluğu. Örneğin, Android'de bu değer, https://developer.android.com/reference/android/location/Location#getAccuracy() yöntemiyle kullanılabilir. Diğer platformlar, benzer doğruluk tahminleri almak için farklı yöntemlere sahiptir.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Derece cinsinden enlem. [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

Seviye

Seviye numarasını ve ilgili adı içeren seviye bilgileri.

JSON gösterimi 
{
  "number": number,
  "name": string
}
Alanlar
number

number

İsteğe bağlı. Sipariş için kullanılan kat numarası. 0 yer seviyesini, 1 ise yer seviyesinin üzerindeki ilk düzeyi, -1 ise yer seviyesinin altındaki ilk seviyeyi belirtir. Tam sayı olmayan değerler kabul edilebilir.
name

string

Zorunlu. Bu Seviyeye atanan ve 3 karakterle sınırlı ad. Bir asansör varsa asansör düğmelerinin bu seviye için nasıl etiketleneceğini düşünün.

Bağ

Bağlantı, kaynak fotoğraftan hedef fotoğrafa bağlantıdır.

JSON gösterimi 
{
  "target": {
    object (PhotoId)
  }
}
Alanlar
target

object (PhotoId)

Zorunlu. İlgili fotoğraftan başka bir fotoğrafa olan bağlantının hedefi.

Yer

Bir varlığın meta verilerini yerleştirin.

JSON gösterimi 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Alanlar
placeId

string

https://developers.google.com/places/place-id adresinde açıklandığı gibi, yer tanımlayıcısı.
name

string

Yalnızca çıkış. Yerin dil kodu ile yerelleştirilmiş adı.
languageCode

string

Yalnızca çıkış. Adın yerelleştirildiği dil kodu. Bu, istekte belirtilen languageCode olmalıdır ancak bir yedek olabilir.

Aktarım Durumu

Hak aktarımının durumu.

Sıralamalar
TRANSFER_STATUS_UNKNOWN Bu aktarımın durumu belirtilmemiş.
NEVER_TRANSFERRED Bu fotoğraf daha önce hiç aktarılmadı.
PENDING Bu fotoğraf aktarımı başlatıldı ancak alıcı henüz yanıt vermedi.
COMPLETED Fotoğraf aktarımı tamamlandı ve bu fotoğraf alıcıya aktarıldı.
REJECTED Alıcı bu fotoğraf aktarımını reddetti.
EXPIRED Alıcı herhangi bir işlem yapmadan önce fotoğraf aktarımının süresi doldu.
CANCELLED Gönderen bu fotoğraf aktarımını iptal etti.
RECEIVED_VIA_TRANSFER Hak aktarımı nedeniyle bu fotoğrafın alıcısı var.

Haritalar Yayınlama Durumu

Fotoğrafın Google Haritalar'daki yayınlanma durumu.

Sıralamalar
UNSPECIFIED_MAPS_PUBLISH_STATUS Fotoğrafın durumu bilinmiyor.
PUBLISHED Fotoğraf, Google Haritalar üzerinden herkese açık olarak yayınlanır.
REJECTED_UNKNOWN Fotoğraf bilinmeyen bir nedenle reddedildi.

Yöntemler

create

 İstemci, fotoğrafı döndürülen UploadRef ile yüklemeyi bitirdikten sonra, CreatePhoto yüklenen Photo öğesini Google Haritalar'daki Street View'da yayınlar.

delete

 Bir Photo ve meta verilerini siler.

get

 Belirtilen Photo meta verilerini alır.

startUpload

 Fotoğraf baytları yüklemeye başlamak için bir yükleme oturumu oluşturur.

update

 Bir Photo ürününün poz, yer ilişkilendirmesi, bağlantılar gibi meta verilerini günceller.