Yer kimliğini edindikten sonra Yer Ayrıntıları (Yeni) isteği göndererek belirli bir işletme veya önemli yer hakkında daha fazla bilgi talep edebilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yer hakkında tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi daha kapsamlı bilgiler döndürür.
Yer kimliğini pek çok şekilde edinebilirsiniz. Şunları kullanabilirsiniz:
- Metin Arama (Yeni) veya Yakındakilerde Arama (Yeni)
- Coğrafi Kodlama API'si
- Routes API
- Adres Doğrulama API'si
- Otomatik Yer Tamamlama
API Explorer, API'yi ve API seçeneklerini tanımanız için canlı isteklerde bulunmanıza olanak tanır:
Deneyin.Yer Ayrıntıları (Yeni) istekleri
Yer Ayrıntıları isteği, aşağıdaki formda bir HTTP GET isteğidir:
https://places.googleapis.com/v1/places/PLACE_ID
Tüm parametreleri, GET isteğinin bir parçası olarak URL parametreleri olarak veya başlıklarda iletin. Örneğin:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
Veya bir cURL komutunda:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Yer Ayrıntıları (Yeni) yanıtları
Yer Ayrıntıları (Yeni), yanıt olarak bir JSON nesnesi döndürür. Yanıtta:
- Yanıt, bir
Place
nesnesiyle temsil edilir.Place
nesnesi, yer hakkında ayrıntılı bilgiler içerir. - İstekte iletilen FieldMask,
Place
nesnesinde döndürülen alanların listesini belirtir.
JSON nesnesinin tamamı şu biçimdedir:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
Gerekli parametreler
-
FieldMask
Yanıt alanı maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin.
$fields
veyafields
URL parametresini ya daX-Goog-FieldMask
HTTP üst bilgisini kullanarak yanıt alanı maskesini yönteme iletin. Yanıtta döndürülen alanların varsayılan bir listesi yoktur. Alan maskesini çıkarırsanız yöntem bir hata döndürür.Alan maskeleme, gereksiz veri isteğinde bulunmadığınızdan emin olmak için iyi bir tasarım uygulamasıdır. Böylece gereksiz işleme süresi ve faturalandırma ücretlerinin önüne geçilir.
Döndürülecek yer verisi türlerinin virgülle ayrılmış listesini belirtin. Örneğin, görünen adı ve yerin adresini alabilirsiniz.
X-Goog-FieldMask: displayName,formattedAddress
Tüm alanları almak için
*
öğesini kullanın.X-Goog-FieldMask: *
Aşağıdaki alanlardan birini veya daha fazlasını belirtin:
Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Kimlik) SKU'sunu tetikler:
id
,name
*,photos
*name
alanı, yer kaynak adını şu biçimde içerir:places/PLACE_ID
. Yerin metin adına erişmek içindisplayName
öğesini kullanın.Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Konum) SKU'sunu tetikler:
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
Aşağıdaki alanlar Yer Ayrıntıları (Temel) SKU'sunu tetikler:
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
,utcOffsetMinutes
Aşağıdaki alanlar Yer Ayrıntıları (Gelişmiş) SKU'sunu tetikler:
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
Aşağıdaki alanlar Yer Ayrıntıları (Tercih Edilen) SKU'sunu tetikler:
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
reservable
,restroom
reviews
,curbsidePickup
reviews
,curbsidePickup
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDesserts
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
-
placeId
Metin Arama (Yeni) veya Yakındaki Arama (Yeni) işlevinden döndürülen ve bir yeri benzersiz şekilde tanımlayan metin biçimli bir tanımlayıcı. Yer kimlikleri hakkında daha fazla bilgi için yer kimliğine genel bakış konusuna bakın.
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ınname
alanında yer alır. Bağımsız yer kimliği, yanıtınid
alanında yer alır.
İsteğe bağlı parametreler
languageCode
Sonuçların döndürüleceği dil.
- Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste tam olmayabilir.
-
languageCode
belirtilmezse API varsayılan olaraken
olur. Geçersiz bir dil kodu belirtirseniz APIINVALID_ARGUMENT
hatası döndürür. - API, hem kullanıcı hem de yerel kullanıcılar tarafından okunabilen bir açık adres sağlamak için elinden geleni yapar. Bu hedefe ulaşmak için yerel dildeki açık adresleri, gerektiğinde kullanıcı tarafından okunabilecek bir alfabeye çevrilmiş olarak, tercih edilen dili gözeterek döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen aynı dilde döndürülür.
- Bir ad, tercih edilen dilde sunulmuyorsa API en yakın eşleşmeyi kullanır.
- Tercih edilen dilin, API'nin döndürmeyi seçtiği sonuç grubu ve bunların döndürülme sırası üzerinde küçük bir etkisi vardır. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı şekillerde yorumlar. Örneğin, sokak türleri için kısaltmalar veya bir dilde geçerli olup bir başka dilde geçerli olmayan eş anlamlılar.
regionCode
Yanıtı biçimlendirmek için kullanılan, iki karakterli CLDR kodu değeri olarak belirtilen bölge kodu. Varsayılan değer yoktur.
Yanıttaki
formattedAddress
alanının ülke adıregionCode
ile eşleşirse ülke koduformattedAddress
öğesinden çıkarılır. Bu parametrenin, ülke adını her zaman içerenadrFormatAddress
veya hiçbir zaman içermeyenshortFormattedAddress
üzerinde etkisi yoktur.Bazı önemli istisnalar dışında CLDR kodlarının çoğu ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"'dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallık'ı" için kullanılır). Parametre, geçerli yasalara göre sonuçları etkileyebilir.
-
sessionToken
Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını "oturumlar" olarak izleyen, kullanıcı tarafından oluşturulmuş dizelerdir. Otomatik Tamamlama (Yeni), bir kullanıcı otomatik tamamlama aramasının sorgu ve yer seçimi aşamalarını faturalandırma amacıyla ayrı bir oturumda gruplandırmak için oturum jetonlarını kullanır. Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını izleyen Yer Ayrıntıları (Yeni) çağrılarına iletilir. Daha fazla bilgi için Oturum jetonları bölümüne bakın.
Yer Ayrıntıları örneği
Aşağıdaki örnekte bir yerin ayrıntıları placeId
tarafından istenir:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
X-Goog-FieldMask
üst bilgisi, yanıtın aşağıdaki veri alanlarını içerdiğini belirtir: id,displayName
.
Ardından yanıt şu biçimde olur:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
Ek bilgiler döndürmek için alan maskesine daha fazla veri türü ekleyin.
Örneğin, yanıta adres ve Artı Kodu'nu dahil etmek için formattedAddress,plusCode
ekleyin:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Yanıt şu biçimdedir:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
Deneyin.
API Explorer, API'yi ve API seçeneklerini tanımanız için örnek isteklerde bulunmanıza olanak tanır.
İstekte bulunmak için:
- Sayfanın sağ tarafındaki API simgesini () seçin.
- İsteğe bağlı olarak
name
parametresini şu şekilde ayarlayın:places/PLACE_ID
- İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve
fields
parametresini alan maskesine ayarlayın. - Yürüt düğmesini seçin. Pop-up pencerede, istekte bulunurken kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde API Gezgini penceresini genişletmek için genişletme simgesini () seçin.