Giriş
Places API, Yer Ayrıntıları (Eski)'yi destekler. Places API (Eski) hakkında bilginiz varsa Yer Ayrıntıları (Yeni) aşağıdaki değişiklikleri yapar:
- Alan maskeleme gereklidir. Yanıtta döndürülmesini istediğiniz alanları belirtmeniz gerekir. Döndürülen alanların varsayılan bir listesi yoktur. Bu listeyi atlarsanız yöntemler bir hata döndürür. Daha fazla bilgi için FieldMask bölümüne bakın.
- Yer Ayrıntıları (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Yer Ayrıntıları (Yeni) yanıt biçimi olarak yalnızca JSON'u destekler.
- Places API (Yeni) için JSON yanıt biçimi, eski 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, Yer Ayrıntıları (Eski) hizmetinde Yer Ayrıntıları (Yeni) için yeniden adlandırılan veya değiştirilen parametreler ya da artık desteklenmeyen parametreler listelenmektedir.
| 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) isteğinden 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ğinde Yer Ayrıntıları (Eski) kullanılır. Bu örnekte, bir yer kimliği hakkında bilgi içeren bir JSON yanıtı istenir ve tüm parametreler URL parametreleri olarak iletilir. Bu örnekte, yanıtın yalnızca yerin görünen adını ve biçimlendirilmiş adresini içermesi için fields da kullanılmıştı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 tüm parametreleri isteğin bir parçası olarak URL parametreleri ve üstbilgilerinde iletirsiniz. Bu örnekte, yanıtın yalnızca yerin görünen adını ve biçimlendirilmiş adresini içermesi için bir 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) isteğinden 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.