Yer kimliğiniz olduktan sonra şunları yapabilirsiniz: belirli bir kurum hakkında daha fazla bilgi talep etmek veya önemli bir noktayı gösteren Yer Ayrıntıları (Yeni) isteğinde bulunabilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yer hakkında daha kapsamlı bilgiler döndürür tam adresi, telefon numarası, kullanıcı puanı ve yorumları gibi.
Yer kimliğini almanın birçok yolu vardır. Şunları kullanabilirsiniz:
- Metin Arama (Yeni) veya Yakında Arama (Yeni)
- Geocoding API
- Routes API
- Address Validation API
- Otomatik Yer Tamamlama
API Gezgini, API'yi ve sunulan API'yi tanıyabilmeniz için canlı isteklerde bulunmanızı sağlar. API seçenekleri:
Deneyin.Yer Ayrıntıları (Yeni) istekleri
Yer Ayrıntıları isteği, formdaki bir HTTP GET isteğidir:
https://places.googleapis.com/v1/places/PLACE_ID
Tüm parametreleri GET isteği. Örneğin:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
Alternatif olarak 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 JSON nesnesi. Yanıtta:
- Yanıt, bir
Place
nesnesini tanımlayın.Place
nesnesi, yer. - İstekte iletilen FieldMask, alanların listesini belirtir
Place
nesnesinde döndürülür.
JSON nesnesinin tamamı aşağıdaki biçimdedir:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
Gerekli parametreler
-
FieldMask
Bir yanıt alanı maskesi oluşturun. URL parametresini kullanarak yanıt alanı maskesini yönteme iletin
$fields
veyafields
ya da HTTP üstbilgisi kullanarakX-Goog-FieldMask
. Yanıtta varsayılan bir döndürülen alan listesi yok. Alan maskesini çıkarırsanız yöntem hata döndürür.Alan maskeleme, bir kullanıcının sizden başka bir alan adına Böylece, gereksiz işlem süresini ve faturalandırma ücretleri.
Döndürülecek yer verisi türlerinin virgülle ayrılmış listesini belirtin. Örneğin, Google Etiket Yöneticisi'ni kullanarak yerin görünen adını ve adresini alın.
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 Kimlikler) SKU'sunu tetikler:
attributions
,id
,name
*,photos
*name
alanında yer kaynak adı yer alır form:places/PLACE_ID
.displayName
hesabını kullan yerin metin adına erişmek için tıklayı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
,reviews
,servesBeer
,servesBreakfast
,servesBrunch
,servesCocktails
,servesCoffee
,servesDessert
,servesDinner
,servesLunch
,servesVegetarianFood
,servesWine
,takeout
-
placeId
Bir araçtan alınan, bir yeri benzersiz şekilde tanımlayan metinsel bir tanımlayıcı Metin Arama (Yeni) veya Yakında Arama (Yeni). Yer kimlikleri hakkında daha fazla bilgi için bkz. yer kimliğine genel bakış.
places/PLACE_ID
dizesi bu yer olarak da adlandırılır 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ı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.
- Bkz. desteklenen dillerin listesini inceleyin. Google genellikle Bu nedenle bu liste tam kapsamlı olmayabilir.
-
languageCode
sağlanmazsa API varsayılan olaraken
olur. Eğer geçersiz bir dil kodu belirtirseniz API,INVALID_ARGUMENT
hatası verir. - API, okunabilir bir açık adres sağlamak için elinden geleni yapar: dahil edilir. Bu hedefe ulaşmak için sokakları yerel dildeki adreslerin harf çevirisi yapılarak okunabilir bir (gerekirse, tercih edilen dili gözeterek) kullanıcı. Diğer tüm ülkeler tercih edilen dilde döndürülür. Adres bileşenleri tümü aynı dilde döndürülür; bu, ilk dilden bir bileşenidir.
- Bir ad tercih edilen dilde sunulmuyorsa API, en yakın eşleşmedir.
- Tercih edilen dilin, arama sonuçlarında görünen döndürmeyi seçtiği sıra ve bunların döndürülme sırasına göre belirlenir. İlgili içeriği oluşturmak için kullanılan coğrafi kod, kısaltmaları dile bağlı olarak farklı şekillerde yorumlar, Örneğin sokak türlerinin kısaltmalarını veya başka bir dilde geçerli olmayabilir.
regionCode
Yanıtı biçimlendirmek için kullanılan bölge kodu, CLDR kodu değerini girin. Varsayılan bir değer yok.
Yanıttaki
formattedAddress
alanının ülke adıregionCode
, ülke koduformattedAddress
öğesinden atlanır. Bu parametrenin, her zaman ülkeyi içerenadrFormatAddress
üzerinde etkisi yoktur. adı veya hiçbir zaman içermeyenshortFormattedAddress
üzerinde.Çoğu CLDR kodu ISO 3166-1 kodlarıyla aynıdır. bazı önemli istisnalarla birlikte. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu "gb" ise (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı"). Parametre, geçerli yasalara göre sonuçları etkileyebilir.
-
sessionToken
Oturum jetonları Otomatik Tamamlama'yı izleyen kullanıcı tarafından oluşturulmuş dizelerdir (Yeni) aramaları "oturumlar" olarak adlandırılır. Otomatik Tamamlama (Yeni), şunları yapmak için oturum jetonlarını kullanır: bir kullanıcı otomatik tamamlama aramasının sorgu ve yer seçimi aşamalarını ayrı bir oturumda gruplandırmak . Oturum jetonları Yer Ayrıntılarına aktarılır (Yeni) Otomatik tamamlama (Yeni) aramalarını takip eden aramalar Daha fazla bilgi için bkz. Oturum jetonları.
Yer Ayrıntıları örneği
Aşağıdaki örnekte bir yerin ayrıntılarına ilişkin bilgiler istenmektedir.
placeId
:
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
üstbilgisinin
yanıt
şu veri alanlarını içerir: id,displayName
.
Bu durumda 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, formattedAddress,plusCode
adresini ve Plus Code'u
yanıt:
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 artık şu formda:
{ "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 Gezgini sayesinde örnek isteklerde bulunabilirsiniz. hakkında da bilgi edineceksiniz.
İstekte bulunmak için:
- API simgesini,
sekmesini tıklayın.
- İ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
parametresi alan maskesine benzer. - Yürüt düğmesini seçin. Pop-up pencerede, kullanmaları gerekir.
API Gezgini panelinde genişlet simgesini seçin, API Gezgini penceresini genişletmek için
tuşlarına basın.