Places API, mevcut Yer Ayrıntıları'nı destekler. Mevcut Places API'ye aşinaysanız Yer Ayrıntıları'nın yeni sürümünde aşağıdaki değişiklikler yapılmıştır:
- Alan maskeleme gereklidir. Yanıtta döndürülmesini istediğiniz alanları belirtmeniz gerekir. Döndürülen alanların varsayılan listesi yok. Bu listeyi çıkarırsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask öğesine bakın.
- Yeni Yer Ayrıntıları, kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Yeni Yer Ayrıntıları'nda yanıt biçimi olarak yalnızca JSON desteklenir.
- Yer Ayrıntıları (Yeni) API için JSON yanıt biçimi, mevcut API'lerin biçiminden farklı şekilde değiştirildi. Daha ayrıntılı bilgi için Places API yanıtını taşıma bölümüne bakın.
Aşağıdaki tabloda, yeni Yer Ayrıntıları için yeniden adlandırılmış veya değiştirilmiş mevcut Yer Ayrıntıları içinde bulunan ya da artık desteklenmeyen parametreler listelenmiştir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
place_id |
places/PLACE_ID |
places/PLACE_ID dizesi, yer kaynak adı olarak da adlandırılır. Yer Ayrıntıları (Yeni),
Yakındaki Arama (Yeni) ve Metin Arama (Yeni)
isteğinden alınan yanıtta, bu dize yanıtın name alanında yer alıyor.
Bağımsız yer kimliği, yanıtın id alanında yer alır. |
language |
languageCode |
|
region |
regionCode |
Örnek istek
Aşağıdaki örnek GET isteği, mevcut Yer Ayrıntıları'nı kullanmaktadır. Bu örnekte, yer kimliği hakkında bilgi içeren bir JSON yanıtı isteğinde bulunuyor ve tüm parametreleri URL parametreleri olarak iletiyorsunuz. Bu örnekte ayrıca fields kullanıldığı için yanıt yalnızca yerin görünen adını ve biçimlendirilmiş adresini içerir:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Yer Ayrıntıları (Yeni) ile bir GET isteği gönderir ve isteğin bir parçası olarak URL parametrelerindeki ve başlıklardaki tüm parametreleri iletirsiniz. Bu örnekte de bir alan maskesi kullanıldığı için yanıt yalnızca yerin görünen adını ve biçimlendirilmiş adresini içerir:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
places/PLACE_ID dizesi, yer kaynak adı olarak da adlandırılır. Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) isteklerinden gelen yanıtta, bu dize yanıtın name alanında yer almaktadır. Bağımsız yer kimliği, yanıtın id alanında yer alır.