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

Places API, mevcut Yer Ayrıntıları. 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 maskeleme gereklidir. Döndürülmesini istediğiniz alanları belirtmeniz gerekir kullanıcı olabilir. Döndürülen alanların varsayılan listesi yok. yöntemler hata döndürür. Daha fazla bilgi için bkz. FieldMask değerine ayarlayın.
  • Yeni Yer Ayrıntıları, her ikisini de destekler API anahtarları ve OAuth kullanmaları gerektiğini unutmayın.
  • 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 bkz. Place API yanıtını taşıyın.

Aşağıdaki tabloda, Adı için yeniden adlandırılan veya değiştirilen Yer Ayrıntıları Yer Ayrıntılarını veya artık yer almayan parametreler desteklenir.

Geçerli parametre Yeni parametre Notlar
place_id places/PLACE_ID places/PLACE_ID dizesi yer kaynak adı. 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ı. 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 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 örnek, bir alan maskesi kullandığı için yanıt yalnızca görünen adı içeriyor ve biçimlendirilmiş adresi:

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ından gelen yanıtta (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) isteği, bu dize şurada bulunuyor: yanıtın name alanına girin. Bağımsız yer kimliği Yanıtın id alanı.