Yerin Fotoğrafları'na taşıma (Yeni)

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Giriş

Places API, Yer Fotoğrafları (Eski)'nı destekler. Yer Fotoğrafları (Eski) özelliğini kullanıyorsanız, Yer Fotoğrafları (Yeni) özelliğinde aşağıdaki değişiklikler yapılmıştır:

  • Yer Fotoğrafları (Yeni) için, istek URL'sinde yer kimliğini içeren fotoğrafın kaynak adını, yalnızca fotoğraf referansı yerine iletmeniz gerekir. Daha fazla bilgi için Fotoğraf referanslarına geçiş başlıklı makaleyi inceleyin.
  • Fotoğrafları Yerleştir (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth belirteçlerini destekler.

Aşağıdaki tabloda, Yer Fotoğrafları (Eski) bölümündeki parametrelerden Yer Fotoğrafları (Yeni) için yeniden adlandırılan veya değiştirilen ya da artık desteklenmeyen parametreler listelenmektedir.

Geçerli parametre Yeni parametre Notlar
maxheight maxHeightPx maxHeightPx, maxWidthPx veya her ikisini de belirtmeniz gerekir.
maxwidth maxWidthPx maxHeightPx, maxWidthPx veya her ikisini de belirtmelisiniz.

Fotoğraf boyutu artırıldı

Yer Fotoğrafları (Eski), maksimum 1.600 x 1.600 piksel fotoğraf boyutunu destekliyordu. Yer Fotoğrafları (Yeni) 4.800 x 4.800 piksele kadar olan boyutları destekler.

Fotoğraf referanslarına geçme

Yer Fotoğrafları (Yeni) API, istenen fotoğrafın kaynak adını (yer kimliği ve fotoğraf referansı dahil) şu biçimde iletmenizi gerektirir:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Yakında Arama (Yeni), Metin Arama (Yeni) ve Yer Ayrıntıları (Yeni) bu biçimi destekleyen yanıtta bir photos[] dizisi döndürür. Yeni yanıttaki photos[] öğesinin her biri aşağıdaki alanları içerir:

  • name — Fotoğrafın kaynak adını içeren bir dize. Bu dize şu biçimdedir:

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx: Resmin piksel cinsinden maksimum yüksekliği.
  • widthPx: Resmin piksel cinsinden maksimum genişliği.
  • authorAttributions[] — Gerekli tüm atıflar. Bu alan her zaman mevcuttur ancak boş olabilir.

Eski API'de yalnızca fotoğraf referansını şu biçimde iletmeniz gerekir:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Yer Bulma (Eski), Yakında Arama (Eski), Metin Arama (Eski) ve Yer Ayrıntıları (Eski) hizmetlerinin tümü, bu biçimi destekleyen yanıtta bir photos[] dizisi döndürür. Eski yanıttaki her photo öğesi aşağıdaki alanları içerir:

  • photo_reference: Fotoğraf isteğinde bulunduğunuzda fotoğrafı tanımlamak için kullanılan dize.
  • height: Resmin maksimum yüksekliği.
  • width: Resmin maksimum genişliği.
  • html_attributions[] — Gerekli tüm atıflar. Bu alan her zaman mevcuttur ancak boş olabilir.