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.
  • Place Photos (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.

Aşağıdaki tabloda, Yer Fotoğrafları (Eski) içinde 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 belirtmeniz gerekir.

Fotoğraf boyutunu artırma

Yer Fotoğrafları (Eski), maksimum 1.600 x 1.600 piksel boyutundaki fotoğrafları 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ı iletmenizi gerektirir. Bu ad, şu biçimde bir yer kimliği ve fotoğraf referansı içerir:

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) yanıtında bu biçimi destekleyen 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 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 photos[] dizisi döndürür. Eski yanıttaki her photo öğesi aşağıdaki alanları içerir:

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