Giriş
Places API, Yer Ayrıntıları (Eski)'nı destekler. Places API'yi (Eski) biliyorsanız Yer Ayrıntıları (Yeni) aşağıdaki değişiklikleri yapar:
- Alan maskeleme gereklidir. Yanıtta hangi alanların döndürülmesini istediğinizi 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) bölümünde yalnızca JSON yanıt biçimi desteklenir.
- Places API'nin (yeni) 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) bölümünde Yer Ayrıntıları (Yeni) için yeniden adlandırılan veya değiştirilen ya da artık desteklenmeyen parametreler listelenmektedir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
place_id |
places/PLACE_ID |
places/PLACE_ID dizesine yer kaynak adı da denir. 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ıttaki 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ılmaktadır. Bu örnekte, bir yer kimliği hakkında bilgi içeren bir JSON yanıtı ister ve tüm parametreleri URL parametreleri olarak iletirsiniz. Bu örnekte fields da kullanıldığından 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 tüm parametreleri isteğin bir parçası olarak URL parametrelerinde ve başlıklarında iletirsiniz. Bu örnekte, yanıtın yalnızca yerin görünen adını ve biçimlendirilmiş adresini içermesi için alan maskesi de kullanılıyor:
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.