Metin Arama (Yeni), bir dizeye dayalı olarak bir dizi yerle ilgili bilgileri döndürür. Örneğin, "İstanbul'da pizza" veya "İstanbul yakınındaki ayakkabı mağazaları" ya da "Ana Cadde No: 123". Hizmet, metin dizesiyle eşleşen yerlerin bir listesiyle ve ayarlanmış olan konum ön yargılarıyla yanıt verir.
Bu hizmet, özellikle otomatik bir sistemde belirsiz adres sorguları yapmak için yararlıdır ve dizenin adres olmayan bileşenleri, hem işletmelerin hem de adreslerin eşleşmesiyle eşleşebilir. Belirsiz adres sorgularına örnek olarak kötü biçimlendirilmiş adresler veya işletme adları gibi adres olmayan bileşenler içeren istekler verilebilir. Aşağıdaki tabloda yer alan ilk iki örnek gibi istekler; bölge, konum kısıtlaması veya konum yanlılığı gibi bir konum ayarlanmadığı sürece sıfır sonuç döndürebilir.
"10 High Street, UK" veya "123 Main Street, ABD" | Birleşik Krallık'ta birden fazla "Ana Cadde", ABD'de birden fazla "Ana Cadde". Bir konum kısıtlaması ayarlanmadığı sürece sorgu, istenen sonuçları döndürmez. |
"Restoran Zincir Restoran İstanbul" | New York'ta birden fazla "ChainRestaurant" konumu; açık adres, hatta sokak adı yok. |
"10 High Street, Escher UK" veya "123 Main Street, Pleasanton Türkiye" | Birleşik Krallık'ın Escher şehrinde sadece bir "High Street"; ABD'nin Pleasanton CA şehrinde sadece bir "Main Street"tir. |
"Benzersiz RestoranAdı İstanbul" | New York'ta bu ada sahip yalnızca bir işletme var; ayırt etmek için açık adres gerekmez. |
"İstanbul'daki pizza restoranları" | Bu sorgu, konum kısıtlaması içeriyor ve "pizza restoranları" iyi tanımlanmış bir yer türü. Birden fazla sonuç döndürür. |
"+1 514-670-8700" | Bu sorgu bir telefon numarası içeriyor. Bu telefon numarasıyla ilişkilendirilmiş yerler için birden fazla sonuç döndürür. |
API Explorer, API ve API seçenekleri hakkında bilgi edinebilmeniz için canlı istekler yapmanıza olanak tanır:
Metin Arama istekleri
Metin Arama isteği, aşağıdaki biçimde bir HTTP POST isteğidir:
https://places.googleapis.com/v1/places:searchText
JSON isteği gövdesindeki veya başlıklardaki tüm parametreleri, POST isteğinin bir parçası olarak iletin. Örneğin:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
Metin Arama (Yeni) yanıtları
Metin Arama (Yeni), yanıt olarak bir JSON nesnesi döndürür. Yanıtta:
places
dizisi, eşleşen tüm yerleri içerir.- Dizideki her yer bir
Place
nesnesiyle temsil edilir.Place
nesnesi, tek bir 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ı aşağıdaki biçimdedir:
{ "places": [ { object (Place) } ] }
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 varsayılan bir döndürülen alan listesi yok. Alan maskesini çıkarırsanız yöntem 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. Bu da gereksiz işleme süresi ve faturalandırma ücretlerinin önlenmesine yardımcı olur.
Döndürülecek yer verisi türlerinin virgülle ayrılmış listesini belirtin. Örneğin, yerin görünen adını ve adresini almak için.
X-Goog-FieldMask: places.displayName,places.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 Metin Arama (Yalnızca Kimlik) SKU'sunu tetikler:
places.attributions
,places.id
,places.name
*,nextPageToken
*places.name
alanı, yer kaynak adını şu biçimde içerir:places/PLACE_ID
. Yerin metin adına erişmek içinplaces.displayName
kullanın.Aşağıdaki alanlar Metin Arama (Temel) SKU'sunu tetikler:
places.accessibilityOptions
,places.addressComponents
,places.adrFormatAddress
,places.businessStatus
,places.displayName
,places.formattedAddress
,places.googleMapsUri
,places.iconBackgroundColor
,places.iconMaskBaseUri
,places.location
,places.photos
,places.plusCode
,places.primaryType
,places.primaryTypeDisplayName
,places.shortFormattedAddress
,places.subDestinations
,places.types
,places.utcOffsetMinutes
,places.viewport
Aşağıdaki alanlar Metin Arama (Gelişmiş) SKU'sunu tetikler:
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
Aşağıdaki alanlar Metin Arama (Tercih Edilen) SKU'sunu tetikler:
places.allowsDogs
,places.curbsidePickup
,places.delivery
,places.dineIn
,places.editorialSummary
,places.evChargeOptions
,places.fuelOptions
,places.goodForChildren
,places.goodForGroups
,places.goodForWatchingSports
,places.liveMusic
,places.menuForChildren
,places.parkingOptions
,places.paymentOptions
,places.outdoorSeating
,places.reservable
,places.restroom
,places.reviews
,places.servesBeer
,places.servesBrunch
, {29,places.servesBeer
,places.servesBeer
places.servesBreakfast
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
-
textQuery
Aranacak metin dizesi, örneğin: "restoran", "Ana Cadde No: 123" veya "İstanbul'da ziyaret edilecek en iyi yer". API, bu dizeye dayalı olarak aday eşleşmeleri döndürür ve sonuçları algılanan alaka düzeyine göre sıralar.
İsteğe bağlı parametreler
includedType
Sonuçları, Tablo A tarafından tanımlanan belirtilen türle eşleşen yerlerle kısıtlar. Yalnızca bir tür belirtilebilir. Örneğin:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
Sonuçların döndürüleceği dil.
- Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sıklıkla güncellediğinden bu liste tam kapsamlı olmayabilir.
-
languageCode
sağlanmazsa API varsayılan olaraken
olur. Geçersiz bir dil kodu belirtirseniz API,INVALID_ARGUMENT
hatası döndürür. - API, hem kullanıcı hem de bölge sakinlerinin okuyabileceği bir açık adres sağlamak için elinden geleni yapar. Bu hedefe ulaşmak için yerel dildeki açık adresleri, gerekirse kullanıcı tarafından okunabilecek bir alfabeye dönüştürülerek tercih edilen dile uyarlar. 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ç kümesi ve 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 ya da bir dilde geçerli olan ancak başka bir dilde geçerli olmayan eş anlamlı kelimeler olabilir.
locationBias
Aranacak alanı belirtir. Bu konum bir sapma görevi görür. Bu da belirtilen alanın dışındaki sonuçlar da dahil olmak üzere belirtilen konumun etrafındaki sonuçların döndürülebileceği anlamına gelir.
locationRestriction
veyalocationBias
belirtebilirsiniz ancak ikisini birden belirtemezsiniz.locationRestriction
öğesini, sonuçların içinde olması gereken bölgeyi belirtmek,locationBias
öğesini ise sonuçların yakınında olması gereken ancak bölgenin dışında olabilecek bölgeyi belirtmek olarak düşünebilirsiniz.Bölgeyi dikdörtgen görünüm veya daire olarak belirtin.
Bir daire, merkez noktası ve metre cinsinden yarıçapla tanımlanır. Yarıçap, 0,0 ile 50.000,0 (her ikisi de dahil) arasında olmalıdır. Varsayılan yarıçap 0,0'dır. Örneğin:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
Dikdörtgen, çapraz olarak zıt yönde iki düşük ve yüksek noktayla temsil edilen, enlem-boylam görüntü alanıdır. Alçak nokta, dikdörtgenin güneybatı köşesini, yüksek nokta ise dikdörtgenin kuzeydoğu köşesini temsil eder.
Görüntü alanı, kapalı bölge olarak kabul edilir. Yani kendi sınırlarını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ila 180 derece (her ikisi de dahil) arasında olmalıdır:
low
=high
olursa görüntü alanı, bu tek noktadan oluşur.low.longitude
>high.longitude
ise boylam aralığı tersine çevrilir (görüntü alanı 180 derecelik boylam çizgisini geçer).low.longitude
= -180 derece vehigh.longitude
= 180 derece olursa görüntü alanı tüm boylamları içerir.low.longitude
= 180 derece vehigh.longitude
= -180 derece olursa boylam aralığı boş olur.low.latitude
>high.latitude
olursa enlem aralığı boş olur.
Hem düşük hem de yüksek alanları doldurulmalıdır ve gösterilen kutu boş bırakılamaz. Boş görüntü alanı hatayla sonuçlanır.
Örneğin, bu görüntü alanı New York City'yi tamamen kapsar:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
locationRestriction
Aranacak alanı belirtir. Belirtilen alanın dışındaki sonuçlar döndürülmez. Bölgeyi dikdörtgen görünüm alanı olarak belirtin. Viewport'u tanımlama hakkında bilgi edinmek için
locationBias
açıklamasına bakın.locationRestriction
veyalocationBias
belirtebilirsiniz ancak ikisini birden belirtemezsiniz.locationRestriction
öğesini, sonuçların içinde olması gereken bölgeyi belirtmek,locationBias
öğesini ise sonuçların yakınında olması gereken ancak bölgenin dışında olabilecek bölgeyi belirtmek olarak düşünebilirsiniz.-
maxResultCount (desteği sonlandırılmış)
Sayfa başına görüntülenecek sonuç sayısını (1 ile 20 arasında) belirtir. Örneğin,
maxResultCount
değerini 5 olarak ayarlamak ilk sayfada en fazla 5 sonuç döndürür. Sorgudan döndürülebilecek daha fazla sonuç varsa yanıt, sonraki sayfaya erişmek için sonraki bir isteğe iletebileceğiniz birnextPageToken
içerir. evOptions
Mevcut elektrikli araç (EV) şarj konnektörlerini ve şarj ücretlerini tanımlamak için parametreleri belirtir.
connectorTypes
Bir yerde bulunan EV şarj konnektörünün türüne göre filtreler. Bağlayıcı türlerinden hiçbirini desteklemeyen yerler filtrelenir. Desteklenen EV şarj konnektörü türleri arasında kombine (AC ve DC) şarj cihazları, Tesla şarj cihazları, GB/T uyumlu şarj cihazları (Çin'de EV hızlı şarj için) ve prizdeki şarj cihazları yer alır. Daha fazla bilgi için referans belgelerini inceleyin.
minimumChargingRateKw
Yerleri, kilovat (kW) cinsinden minimum EV şarj hızına göre filtreler. Minimum şarj hızının altında şarj olan yerler filtrelenir. Örneğin, en az 10 kW şarja sahip EV şarj cihazlarını bulmak için bu parametreyi "10" olarak ayarlayabilirsiniz.
minRating
Sonuçları, yalnızca ortalama kullanıcı puanı bu sınırdan yüksek veya bu sınıra eşit olanlarla kısıtlar. Değerler 0,5’lik artışlarla 0,0 ile 5,0 (dahil) arasında olmalıdır. Örneğin: 0, 0,5, 1,0, ... , 5,0 dahil bu sayılar. Değerler, en yakın 0,5'e yuvarlanır. Örneğin, 0,6 değeri 1,0'dan düşük olan tüm sonuçları eler.
openNow
true
ise yalnızca sorgunun gönderildiği sırada açık olan yerleri döndürün.false
ise açık durumundan bağımsız olarak tüm işletmeleri döndürün. Bu parametreyifalse
olarak ayarlarsanız Google Rehber veritabanında çalışma saatlerini belirtmeyen yerler döndürülür.pageSize
Sayfa başına görüntülenecek sonuç sayısını (1 ile 20 arasında) belirtir. Örneğin,
pageSize
değerini 5 olarak ayarlamak ilk sayfada en fazla 5 sonuç döndürür. Sorgudan döndürülebilecek daha fazla sonuç varsa yanıt, sonraki sayfaya erişmek için sonraki bir isteğe iletebileceğiniz birnextPageToken
içerir.pageToken
Önceki sayfanın yanıt gövdesindeki
nextPageToken
öğesini belirtir.-
priceLevels
Aramayı belirli fiyat düzeylerinde işaretlenmiş yerlerle sınırlandırın. Varsayılan olarak tüm fiyat düzeyleri seçilir.
PriceLevel
ile tanımlanan bir veya daha fazla değerden oluşan bir dizi belirtin.Örneğin:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
Sonuçların, sorgunun türüne göre yanıtta nasıl sıralandığını belirtir:
- "İstanbul'daki restoranlar" gibi bir kategorik sorgu için varsayılan değer
RELEVANCE
(sonuçları arama alaka düzeyine göre sırala)dır.rankPreference
değeriniRELEVANCE
veyaDISTANCE
(sonuçları mesafeye göre sırala) olarak ayarlayabilirsiniz. - "Mountain View, CA" gibi kategorik olmayan bir sorgu için
rankPreference
politikasını ayarlamadan bırakmanızı öneririz.
- "İstanbul'daki restoranlar" gibi bir kategorik sorgu için varsayılan değer
regionCode
Yanıtı biçimlendirmek için kullanılan bölge kodu. İki karakterli CLDR kodu değeri olarak belirtilir. Bu parametrenin arama sonuçları üzerinde yanlılık etkisi de olabilir. Varsayılan bir değer yok.
Yanıttaki
formattedAddress
alanının ülke adıregionCode
ile eşleşirse ülke koduformattedAddress
öğesinden çıkarılır. Bu parametrenin, mevcut olduğunda her zaman ülke adını içerenadrFormatAddress
veya hiçbir zaman içermeyenshortFormattedAddress
üzerinde etkisi yoktur.CLDR kodların çoğu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu "gb" (teknik olarak "Büyük Britanya ve Kuzey İrlanda'daki Birleşik Krallık'a" ait tüzel kişi için) "gb" şeklindedir. Parametre, geçerli yasalara göre sonuçları etkileyebilir.
strictTypeFiltering
includedType
parametresiyle kullanılır.true
olarak ayarlandığında, yalnızcaincludeType
tarafından belirtilen türlerle eşleşen yerler döndürülür. False (yanlış) değerine ayarlandığında varsayılan yanıt, belirtilen türlerle eşleşmeyen yerler içerebilir.
Metin Arama örnekleri
Sorgu dizesine göre yer bulma
Aşağıdaki örnekte "Sydney, Avustralya'da Acılı Vejetaryen Yemekler" için bir Metin Arama isteği gösterilmektedir:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
X-Goog-FieldMask
üstbilgisinin, yanıtın şu veri alanlarını içerdiğini belirttiğini unutmayın: places.displayName,places.formattedAddress
.
Bu durumda yanıt şu biçimde olur:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
Ek bilgiler döndürmek için alan maskesine daha fazla veri türü ekleyin.
Örneğin yanıta restoran türünü ve web adresini dahil etmek için places.types,places.websiteUri
ekleyin:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \ 'https://places.googleapis.com/v1/places:searchText'
Yanıt artık şu formda:
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
Yerleri fiyat düzeyine göre filtrele
Sonuçları pahalı olmayan veya orta düzeyde pahalı olarak tanımlanan restoranlara göre filtrelemek için priceLevel
seçeneğini kullanın:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia", "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
Bu örnekte, X-Goog-FieldMask
üst bilgisi de yanıta places.priceLevel
veri alanını eklemek için kullanılır ve böylece form şu şekilde olur:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
Aramanızı daraltmak için includedType
, minRating
, rankPreference
, openNow
gibi ek seçenekler ve İsteğe bağlı parametreler bölümünde açıklanan diğer parametreler ekleyin.
Bir bölgedeki yerleri arama
Aramayı bir alanla sınırlamak için locationRestriction
veya locationBias
kullanın (ikisini birden kullanmayın). locationRestriction
öğesini, sonuçların içinde olması gereken bölgeyi belirtmek, locationBias
öğesini de sonuçların yakın olması gereken ancak bölgenin dışında olabileceği bölgeyi belirtmek olarak düşünebilirsiniz.
Aşağıdaki örnekte, San Francisco şehir merkezindeki bir noktaya en fazla 500 metre mesafede olan "Acı Vejetaryen Yemek" için bir Metin Arama isteği gösterilmektedir. Bu istek, açık olan yerler için yalnızca ilk 10 sonucu döndürür.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "pageSize": 10, "locationBias": { "circle": { "center": {"latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } }, }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Minimum şarj hızına sahip EV şarj cihazlarını arayın.
EV'nizle uyumlu şarj noktalarının bulunduğu yerleri aramak için minimumChargingRateKw
ve connectorTypes
özelliklerini kullanın.
Aşağıdaki örnekte, Mountain View, Kaliforniya'da minimum 10 kW şarj hızına sahip Tesla ve J1772 tür 1 EV şarj konnektörleri için yapılan bir istek gösterilmektedir. Yalnızca dört sonuç döndürülür.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "pageSize": 4, "evOptions": { "minimumChargingRateKw": 10, "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"] } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \ 'https://places.googleapis.com/v1/places:searchText'
İstek, aşağıdaki yanıtı döndürür:
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
Sayfa başına döndürülecek sonuç sayısını belirtin
Sayfa başına döndürülecek sonuç sayısını belirtmek için pageSize
parametresini kullanın. Yanıt gövdesindeki nextPageToken
parametresi, sonraki sonuçlar sayfasına erişmek için sonraki çağrılarda kullanılabilecek bir jeton sağlar.
Aşağıdaki örnekte, sayfa başına 5 sonuçla sınırlı olan "New York'ta pizza" isteği gösterilmektedir:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
Sonraki sonuç sayfasına erişmek için istek gövdesinde nextPageToken
öğesini iletmek için pageToken
öğesini kullanın:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5, "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
Deneyin.
API Gezgini, API ve API seçeneklerini tanıyabilmeniz için örnek isteklerde bulunmanıza olanak tanır.
Sayfanın sağ tarafındaki API simgesini () seçin.
İsteğe bağlı olarak Standart parametreleri göster seçeneğini genişletin ve
fields
parametresini alan maskesi olarak ayarlayın.İsteğe bağlı olarak İstek gövdesini düzenleyin.
Yürüt düğmesini seçin. Pop-up iletişim kutusunda, istekte bulunmak için kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde genişletme simgesini () seçerek API Gezgini penceresini genişletin.