Places API, mevcut Yer Ayrıntıları'nı destekler. Mevcut Places API'yi biliyorsanız Yer Ayrıntıları'nın yeni sürümünde aşağıdaki değişiklikler yapılmıştır:
- Alan maskelemesi gereklidir. Yanıtta döndürülmesini istediğiniz alanları belirtmeniz gerekir. Döndürülen alanların varsayılan listesi yoktur. Bu listeyi atlarsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask konusuna 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'sinin JSON yanıt biçimi, mevcut API'lerin biçiminden farklıdır. Daha fazla bilgi için Places API yanıtını taşıma başlıklı makaleyi inceleyin.
Aşağıdaki tabloda, mevcut Yer Ayrıntıları'nda yeni Yer Ayrıntıları için yeniden adlandırılmış veya değiştirilmiş parametreler 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ında Arama (Yeni) ve Metin Arama (Yeni) isteklerinden gelen yanıtta bu dize, yanıtın name alanında yer alır.
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ı kullanır. Bu örnekte, bir yer kimliğiyle ilgili bilgileri içeren bir JSON yanıtı ister ve tüm parametreleri URL parametreleri olarak iletirsiniz. Bu örnekte de fields kullanıldığı için yanıtta yalnızca yerin görünen adı ve biçimlendirilmiş adresi yer alır:
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 URL parametrelerindeki ve başlıklardaki tüm parametreleri istek kapsamında iletirsiniz. Bu örnekte, yanıtta yalnızca yerin görünen adı ve biçimlendirilmiş adresinin yer alması için alan maskesi de kullanılır:
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ında Arama (Yeni) ve Metin Arama (Yeni) isteklerinden gelen yanıtta bu dize, yanıtın name alanında yer alır. Bağımsız yer kimliği, yanıtın id alanında yer alır.