Giriş
Places API, Yer Fotoğrafları (Eski)'nı destekler. Yer Fotoğrafları (Eski) özelliğini kullanıyorsanız Yer Fotoğrafları (Yeni) aşağıdaki değişiklikleri yapar:
- Yer Fotoğrafları (Yeni) için istek URL'sinde yalnızca fotoğraf referansı yerine yer kimliğini içeren fotoğrafın kaynak adını iletmeniz gerekir. Daha fazla bilgi için Fotoğraf referanslarında değişiklik başlıklı makaleyi inceleyin.
- Yer Fotoğrafları (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. |
Fotoğraf boyutunu artırma
Place Photos (Eski) maksimum 1600x1600 piksel boyutunda fotoğrafları destekliyordu. Yer Fotoğrafları (Yeni) 4.800 x 4.800 piksele kadar olan boyutları destekler.
Fotoğraf referanslarına geçiş
Yer Fotoğrafları (Yeni) API'si, istenen fotoğrafın kaynak adını iletmenizi gerektirir. Bu ad, şu biçimde yer kimliği ve fotoğraf referansı 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) bu biçimi destekleyen yanıtta 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
Find Place (Eski), Yakında Arama (Eski), Text Search (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.