Yer Fotoğrafına Taşı (Yeni)

Places API, mevcut yer fotoğrafını destekler. Mevcut yer fotoğrafını biliyorsanız yer fotoğrafının yeni sürümünde aşağıdaki değişiklikler yapılmıştır:

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

Aşağıdaki tabloda, mevcut yer fotoğrafında yeni yer fotoğrafı için yeniden adlandırılmış veya değiştirilmiş parametreler ya da artık desteklenmeyen parametreler listelenmiştir.

Mevcut parametre Yeni parametre Notlar
maxheight maxHeightPx maxHeightPx, maxWidthPx veya her ikisini de belirtmeniz gerekir.
maxwidth maxWidthPx maxHeightPx, maxWidthPx veya her ikisini de belirtmeniz gerekir.

Artırılmış fotoğraf boyutu

Mevcut yer fotoğrafı, maksimum 1.600x1.600 piksel boyutunda fotoğrafları destekler. Fotoğraf Yerleştir (Yeni) özelliği 4.800x4.800 piksele kadar boyutları destekler.

Fotoğraf referanslarına geçiş

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

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

Yakındaki Arama, Metin Arama ve Yer Ayrıntıları'nın yeni sürümleri, yanıtta 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 şekildedir:

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

Mevcut API ile yalnızca fotoğraf referansını şu şekilde iletmeniz gerekir:

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

Mevcut Yer Bul, Yakındakiler Arama, Metin Arama ve Yer Ayrıntıları, yanıtta bu biçimi destekleyen bir photos[] dizisi döndürür. Mevcut yanıttaki her photo öğesi aşağıdaki alanları içerir:

  • photo_reference: Fotoğraf isteği gönderdiğinizde fotoğrafı tanımlamak için kullanılan bir dize.
  • height: Resmin maksimum yüksekliği.
  • width: Resmin maksimum genişliği.
  • html_attributions[]: Gerekli tüm ilişkilendirmeler. Bu alan her zaman mevcuttur ancak boş olabilir.