Places API mevcut Yer Fotoğrafı'nı destekler. Mevcut Yer Fotoğrafı hakkında bilginiz varsa Yer Fotoğrafı'nın yeni sürümünde şu değişiklikler yapılacak:
- Yeni Yer Fotoğrafı hizmeti, yalnızca fotoğraf referansı yerine fotoğrafın kaynak adını iletmenizi gerektirir. Bu ad, istek URL'sindeki yer kimliğini içerir. Daha fazla bilgi için Fotoğraf referanslarında değişiklik yapma başlıklı makaleye göz atın.
- 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 bulunan ve 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 büyütüldü
Mevcut Yer Fotoğrafı maksimum 1600x1600 piksellik bir fotoğraf boyutunu destekliyordu. Yer Fotoğrafı (Yeni) 4800 x 4800 piksele kadar boyutları destekler.
Fotoğraf referanslarında değiştir
Yeni Place Photo API'si, istenen fotoğrafın kaynak adını, yer kimliği ve fotoğraf referansını aşağıdaki 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ümlerinin tümü, bu biçimi destekleyen yanıtta bir photos[] dizisi döndürür. Yeni yanıttaki her photos[] öğesi 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 ilişkilendirmeler. 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ındaki Arama, Metin Arama ve Yer Ayrıntıları özelliklerinin tümü, bu biçimi destekleyen yanıtta 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 gerçekleştirdiğinizde fotoğrafı tanımlamak için kullanılan dize.height: Resmin maksimum yüksekliği.width: Resmin maksimum genişliği.html_attributions[]: Gerekli ilişkilendirmeler. Bu alan her zaman mevcuttur, ancak boş olabilir.