Places API, Yer Ayrıntıları (Eski)'nı destekler. Places API (eski) hakkında bilginiz varsa Yer Ayrıntıları (yeni) aşağıdaki değişiklikleri yapar:
- 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.
- 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) özelliğinde yanıt biçimi olarak yalnızca JSON desteklenir.
- 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) bölümünde yer alan ve Yer Ayrıntıları (Yeni) 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, Yer Ayrıntıları (eski) özelliğini 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 fields de 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 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ındakiler 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.