Giriş
Places API, Place Photos (Eski)'yu destekler. Place Photos (Eski) hizmetini biliyorsanız Place Photos (Yeni) aşağıdaki değişiklikleri yapar:
- Place Photos (Yeni), yalnızca fotoğraf referansı yerine, istek URL'sinde yer kimliğini içeren fotoğrafın kaynak adını iletmenizi gerektirir. Daha fazla bilgi için Fotoğraf referanslarında yapılan değişiklik başlıklı makaleyi inceleyin.
- Place Photos (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
Aşağıdaki tabloda, Place Photos (Eski) hizmetinde Place Photos (Yeni) için yeniden adlandırılan veya değiştirilen parametreler ya da artık desteklenmeyen parametreler listelenmiştir.
| Geçerli 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
Place Photos (Eski), maksimum 1600x1600 piksel boyutunda fotoğrafları destekliyordu. Place Photos (New), 4.800 x 4.800 piksele kadar olan boyutları destekler.
Fotoğraf referanslarına geçiş
Place Photos (New) API, istenen fotoğrafın kaynak adını iletmenizi gerektirir. Bu ad, yer kimliği ve fotoğraf referansını şu biçimde içerir:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Yakında Arama (Yeni),
Metin Arama (Yeni) ve
Yer Ayrıntıları (Yeni)
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 tüm atıflar. Bu alan her zaman mevcuttur ancak boş olabilir.
Eski API'de 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) yöntemlerinin tümü, bu biçimi destekleyen yanıtta 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 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.