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, Yer Fotoğrafları (Eski) içinde Yer Fotoğrafları (Yeni) için yeniden adlandırılan veya değiştirilen ya da artık desteklenmeyen parametreler listelenmektedir.
| 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
Yer Fotoğrafları (Eski) en fazla 1.600 x 1.600 piksel boyutundaki fotoğrafları destekliyordu. Yer Fotoğrafları (Yeni) 4.800 x 4.800 piksele kadar olan boyutları destekler.
Fotoğraf referanslarına geçme
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 (Legacy), Yakında Arama (Legacy), Text Search (Legacy) ve Yer Ayrıntıları (Legacy) işlevlerinin tümü, bu biçimi destekleyen yanıtta photos[] dizisi döndürür. Eski yanıttaki her photo öğesi aşağıdaki alanları içerir:
photo_reference: Fotoğraf isteği yaptığınızda 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.