Yer Ayrıntılarına Taşı (Yeni)

Places API, mevcut Yer Ayrıntıları'nı destekler. Mevcut Places API'si hakkında bilginiz varsa, Yer Ayrıntıları'nın yeni sürümü 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. 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ı.
  • Yer Ayrıntıları için JSON yanıt biçimi (Yeni) API, mevcut API'lerin biçiminden farklı bir biçime sahiptir. 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ından (Yeni) aldığımız yanıtta, Yakındaki Arama (Yeni) ve Metin Arama (Yeni) 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 JSON bir yer kimliği hakkında bilgi içeren ve tüm parametreleri URL olarak ileten yanıt parametreleridir. Bu örnekte de fields kullanıldığı için yanıt yalnızca şunu içerir: yerin görünen adı ve biçimlendirilmiş adresi:

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 GET isteğinde bulunur ve isteğin bir parçası olarak URL parametrelerindeki ve başlıklarındaki tüm parametreleri iletmelidir. Bu örnekte, yanıtta yalnızca yerin görünen adı ve biçimlendirilmiş adresinin yer alması için bir alan maskesi de kullanılmıştı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 bu yer olarak da adlandırılır kaynak adı. 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ı.