REST Resource: photo

Kaynak: Fotoğraf

Fotoğraflar, 360° fotoğrafları fotoğraf meta verileriyle birlikte 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üncellerken gerekir. Yalnızca fotoğraf oluştururken çıktı ver. Google'daki tüm fotoğraflar arasında 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ış. Belirtilen fotoğrafın önizlemesini gösteren küçük resim URL'si.
pose

object (Pose)

İsteğe bağlı. Fotoğrafın duruşu.
connections[]

object (Connection)

İsteğe bağlı. Başka fotoğraflarla bağlantılar. Bağlantı, bu fotoğraftan başka bir fotoğrafa verilen 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 fotoğraf meta verilerine zaman damgası eklemek için bu zaman damgası kullanılır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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ğraftaki hak aktarımının durumu.
mapsPublishStatus

enum (MapsPublishStatus)

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

PhotoId

Photo için tanımlayıcı.

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

string

Bir fotoğrafın benzersiz tanımlayıcısıdır.

UploadRef

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
Birleştirme alanı file_source. Zorunlu. file_source şunlardan yalnızca biri olabilir:
uploadUrl

string

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

Poz

Bir varlık için ham 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)

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

number

Pozun, WGS84 elipsoit üzerinde metre cinsinden yüksekliği. NaN, ölçülmeyen miktarı gösterir.
heading

number

Aşağıdaki poz parametreleri fotoğrafın merkeziyle ilgilidir. https://developers.google.com/streetview/spherical-metadata ile eşleşir. Kuzeyden saat yönünde, fotoğrafın ortasında ölçülen pusula yönü. Değer en az 0 ve en fazla 360 olmalıdır. NaN, ölçülmeyen miktarı gösterir.
pitch

number

Derece olarak fotoğrafın ortasında ölçülen perde. Değer en az -90 ve en fazla 90 olmalıdır. -90 değeri doğrudan aşağıya, 90 değeri ise doğrudan yukarıya bakmayı ifade eder. NaN, ölçülmeyen miktarı gösterir.
roll

number

Yuvarlanma (derece cinsinden). Değer en az 0 ve en fazla 360 olmalıdır. 0 değeri, ufuk çizgisi olan seviyeyi ifade eder. NaN, ölçülmeyen miktarı gösterir.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

UTC döneminden bu yana GPS kaydının zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 seviye (bir binadaki kat).
accuracyMeters

number

Bu pozun, %68 güven düzeyiyle (bir standart sapma) metre cinsinden tahmini yatay doğruluğu. Örneğin, Android'de bu değer şu yöntemden kullanılabilir: https://developer.android.com/reference/android/location/Location#getAccuracy(). Diğer platformlarda benzer doğruluk tahminleri almak için farklı yöntemler kullanılmaktadır.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift ç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ı. Kat numarası, sipariş için kullanılır. 0 zemin seviyesini, 1 yer seviyesinden ilk seviyeyi, -1 ise yer seviyesinin altındaki ilk seviyeyi gösterir. Tam sayı olmayan değerler sorun teşkil etmez.
name

string

Zorunlu. Bu Seviyeye atanan, 3 karakterle sınırlandırılmış bir ad. Asansör olsaydı bu kat için asansör düğmelerinin nasıl etiketleneceğini düşünün.

Bağlantı

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

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

object (PhotoId)

Zorunlu. Bulunduğu fotoğraf ile başka bir fotoğraf arasındaki bağlantının hedefi.

Yer

Varlık için meta veri yerleştirme.

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

string

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

string

Yalnızca çıkış. Yerin languageCode'a yerelleştirilmiş adı.
languageCode

string

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

TransferStatus

Hak aktarımının durumu.

Sıralamalar
TRANSFER_STATUS_UNKNOWN Bu aktarımın durumu belirtilmedi.
NEVER_TRANSFERRED Bu fotoğraf hiçbir zaman 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 alıcıya ait.

MapsPublishStatus

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, döndürülen UploadRef ile fotoğrafı yüklemeyi bitirdikten sonra CreatePhoto, yüklenen Photo öğesini Google Haritalar'da Street View'da yayınlar.

delete

 Photo öğesini ve meta verilerini siler.

get

 Belirtilen Photo öğesinin meta verilerini alır.

startUpload

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

update

 Poz, yer ilişkilendirmesi, bağlantılar gibi bir Photo öğesinin meta verilerini günceller.