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ü aşağıdaki değişiklikleri yapar:
- Yeni Yer Fotoğrafı hizmeti, istek URL'sinde yalnızca fotoğraf referansı yerine yer kimliğini de içeren fotoğrafın kaynak adını iletmenizi gerektirir. Daha fazla bilgi için Fotoğraf referanslarında değişiklik yapma bölümüne bakı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, yeni Yer Fotoğrafı için yeniden adlandırılmış veya değiştirilmiş mevcut Yer Fotoğrafı ya da artık desteklenmeyen parametreler listelenmiştir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
maxheight |
maxHeightPx |
maxHeightPx, maxWidthPx veya her ikisini de belirtmelisiniz. |
maxwidth |
maxWidthPx |
maxHeightPx, maxWidthPx veya her ikisini de belirtmelisiniz. |
Fotoğraf boyutu büyütüldü
Mevcut Yer Fotoğrafı, maksimum 1600 x 1600 piksel boyutunu destekliyordu. Yer Fotoğrafı (Yeni) 4800 x 4800 piksele kadar boyutları destekler.
Fotoğraf referanslarında değişiklik
Yeni Place Photo 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ı özelliklerinin tümü, yanıtta bu biçimi destekleyen 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 atıflar. Bu alan her zaman mevcuttur ancak boş olabilir.
Mevcut API ile yalnızca fotoğraf referansını aşağıdaki biçimde iletmeniz gerekir:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Mevcut Yer Bulma, Yakında Arama, Metin Arama ve Yer Ayrıntılarının 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— Bir 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 atıflar. Bu alan her zaman mevcuttur ancak boş olabilir.