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

Places API, yer fotoğrafını (eski) destekler. Fotoğraf yerleştirme (eski) özelliğini kullanıyorsanız Fotoğraf yerleştirme (yeni) özelliğinde aşağıdaki değişiklikler yapılmıştır:

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

Aşağıdaki tabloda, Yer Fotoğrafı (Eski) özelliğinde yer alan ve Yer Fotoğrafı (Yeni) özelliği için yeniden adlandırılmış veya değiştirilmiş parametreler ya da artık desteklenmeyen parametreler listelenmiştir.

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

Fotoğraf boyutu artırıldı

Fotoğraf Yerleştir (eski) özelliği, en fazla 1.600x1.600 piksel boyutunda fotoğrafları destekler. Fotoğraf Yerleştir (Yeni) özelliği, 4.800x4.800 piksel boyutuna kadar olan resimleri destekler.

Fotoğraf referanslarına geçme

Yer Fotoğrafı (Yeni) API, 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ındakiler Arama (Yeni), Metin Arama (Yeni) ve Yer Ayrıntıları (Yeni) özellikleri, 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 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.

Mevcut API ile 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) isteklerinin tümü, yanıtta bu biçimi destekleyen bir photos[] dizisi döndürür. Eski 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 atıflar. Bu alan her zaman mevcuttur ancak boş olabilir.