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

Places API mevcut Yer Ayrıntıları'nı destekler. Mevcut Places API hakkında bilginiz varsa Yer Ayrıntıları'nın yeni sürümü 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 çıkarırsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask bölümüne 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ı'nda yanıt biçimi olarak yalnızca JSON desteklenir.
  • Place Details (Yeni) API'si için JSON yanıt biçimi, mevcut API'lerin biçiminden farklıdır. Daha fazla bilgi için Place API yanıtını taşıma bölümüne bakın.

Aşağıdaki tabloda, mevcut Yer Ayrıntılarında bulunan, yeni Yer Ayrıntıları için yeniden adlandırılmış veya değiştirilmiş 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ğine verilen 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, mevcut Yer Ayrıntılarını kullanır. Bu örnekte, yer kimliği hakkında bilgi içeren bir JSON yanıtı ister ve tüm parametreleri URL parametreleri olarak geçirirsiniz. Bu örnekte fields kullanıldığı için yanıt yalnızca yerin görünen adını ve biçimlendirilmiş adresini içerir:

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) seçeneğiyle bir GET isteği oluşturup URL parametreleri ve başlıklarındaki tüm parametreleri isteğin parçası olarak iletirsiniz. Bu örnekte ayrıca bir alan maskesi kullanıldığından yanıt, yalnızca yerin görünen adını ve biçimlendirilmiş adresini içerir:

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 dizesine yer kaynak adı da denir. Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) isteğine verilen 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.