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.
| 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ı
Mevcut yer fotoğrafı, maksimum 1.600x1.600 piksel boyutunda fotoğrafları desteklemektedir. Fotoğraf Yerleştir (Yeni) özelliği 4.800x4.800 piksel boyuta kadar destekler.
Fotoğraf referanslarına geçme
Yeni Yer Fotoğrafı API'si, istenen fotoğrafın kaynak adını (yer kimliğini ve fotoğraf referansını 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, 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 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
Mevcut Yer Bulma, Yakındakiler Arama, Metin Arama ve Yer Ayrıntıları'nın tümü, 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 dizedir.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.