Metin Arama (Yeni)

Platform seçin: Android iOS JavaScript Web Hizmeti

Metin Arama (Yeni) bir dizeye bağlı olarak bir yer dizisiyle ilgili bilgileri döndürür; örneğin, "İstanbul'da pizza" veya "İstanbul yakınındaki ayakkabı mağazaları" veya "Ana Cadde No: 123". İlgili içeriği oluşturmak için kullanılan hizmet, metin dizesiyle ve herhangi bir konumla eşleşen yerlerin bir listesiyle yanıt verir varsayılan olarak ayarlanır.

Bu hizmet, özellikle de belirsiz adres sorguları dizenin adres dışı bileşenleri birbiriyle eşleşebilir birlikte çalışır. Belirsiz adres sorgusu örnekleri: gibi adres olmayan bileşenleri içeren kötü biçimlendirilmiş adresler veya istekler ekleyebilirsiniz. Aşağıdaki tabloda yer alan ilk iki örnek gibi istekler bir konum (ör. bölge, konum) olmadığı sürece sıfır sonuç döndürebilir. veya konum ön yargısı nasıl belirlendiğini ifade eder.

"10 High Street, Birleşik Krallık" veya "Ana Cadde No: 123, Türkiye" Birleşik Krallık'ta birden fazla "High Street"s; ABD'de birden fazla "Ana Cadde" var. Konum kısıtlaması geçerli değilse sorgu, istenen sonuçları döndürmüyor. ayarlandı.
"Restoran Zincir Restoran İstanbul" Birden çok "ChainRestaurant" New York'taki konumlar; açık adres yok veya Hatta sokak adı bile olabilir.
"İstiklal Caddesi 10, İstanbul" veya "İstiklal Caddesi No:123, İstanbul" Yalnızca bir tane "Ana Cadde" İngiltere'nin Escher şehrinde; sadece bir tane "Ana Cadde" bir e-posta alırsınız.
"Benzersiz RestoranAdı İstanbul" New York'ta bu ada sahip yalnızca bir işletme; açık adres yok gerekli olduğu anlamına gelir.
"İstanbul'daki pizza restoranları" Bu sorgu, konum kısıtlaması ve "pizza restoranları" ifadesini içeriyor : iyi tanımlanmış bir yer türü olabilir. Birden fazla sonuç döndürür.
"+1 514-670-8700"

Bu sorgu bir telefon numarası içeriyor. Şunun için birden fazla sonuç döndürür: yer alır.

API Gezgini, API'yi ve sunulan API'yi tanıyabilmeniz için canlı isteklerde bulunmanızı sağlar. API seçenekleri:

Deneyin.

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 istek gövdesindeki veya POST isteği. Ö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) işlevinde Yanıt olarak JSON nesnesi. Yanıtta:

  • places dizisi, eşleşen tüm yerleri içerir.
  • Dizideki her yer bir Place nesnesini tanımlayın. Place nesnesi, tek bir öğe hakkında ayrıntılı bilgiler içeriyor yer.
  • İstekte iletilen FieldMask, Place nesnesinde döndürülen alanların listesi.

JSON nesnesinin tamamı aşağıdaki biçimdedir:

{
  "places": [
    {
      object (Place)
    }
  ]
}

Gerekli parametreler

  • FieldMask

    Bir yanıt alanı maskesi oluşturun. URL parametresini kullanarak yanıt alanı maskesini yönteme iletin $fields veya fields ya da HTTP üstbilgisi kullanarak X-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: 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ında yer kaynak adı yer alır form: places/PLACE_ID. places.displayName hesabını kullan yerin metin adına erişmek için tıklayı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.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

  • textQuery

    Aranacak metin dizesi, örneğin: "restoran", "İstiklal Caddesi No:123" ya da "İstanbul'da ziyaret edilecek en iyi yer". API aday eşleşmelerini temel alarak döndürür dizeyi temel alır ve sonuçları algılanan alaka düzeylerine göre sıralar.

İsteğe bağlı parametreler

  • includedType

    Sonuçları, tarafından tanımlanan belirtilen türle eşleşen yerlerle kısıtlar Tablo A. Yalnızca bir tür belirtilebilir. Örneğin:

    • "includedType":"bar"
    • "includedType":"pharmacy"

  • languageCode

    Sonuçların döndürüleceği dil.

    • Bkz. desteklenen dillerin listesini inceleyin. Google desteklenen dilleri sık sık güncellediğinden bu liste kapsamlıdır.
    • languageCode sağlanmazsa API varsayılan olarak en. Geçersiz bir dil kodu belirtirseniz API, INVALID_ARGUMENT hatası döndürür.
    • 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.

  • locationBias

    Aranacak alanı belirtir. Bu konum, belirli bir belirtilen konumun etrafındaki sonuçlar, şunun sonuçları da dahil olmak üzere döndürülebilir: belirtilen alanın dışına çıktı.

    locationRestriction veya locationBias, ancak her ikisi birden değil. locationRestriction, sonuçların içinde olması gereken bölge ve locationBias olarak sonuçların yakınında olması gereken ancak dışında olabilecek bölgeyi belirtmek inceleyeceğiz.

    Bölgeyi dikdörtgen görünüm veya daire olarak belirtin.

    • Bir daire, merkez noktası ve metre cinsinden yarıçapıyla tanımlanır. Yarıçap 0,0 ile 50000,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, iki şekilde gösterilen enlem-boylam görünümüdür alt ve yüksek noktaların karşısında çapraz olarak çapraz çizgi bulunur. En düşük nokta güneybatıyı işaret eder dikdörtgenin köşesi, yüksek nokta ise kuzeydoğuyu köşesine dokunun.

      Görüntü alanı, yani kendi sınırını içerir. Enlem sınırları -90 ile 90 derece (her ikisi de dahil) arasında olmalı ve boylam sınırları -180 ile 180 derece (her iki değer dahil) arasında olmalıdır:

      • low = high olursa görüntü alanı şunları içerir: tek bir noktaya parmak bastınız.
      • Eğer low.longitude > high.longitude, boylam aralığı ters çevrilmiş (görüntü alanı 180 dereceyi geçiyor boylam çizgisi) içerir.
      • low.longitude = -180 derece ve high.longitude = 180 derece, görüntü alanı tüm boylamlar.
      • low.longitude = 180 derece ve high.longitude = -180 derece, boylam aralığı boştur.
      • Eğer low.latitude > high.latitude, enlem aralığı boş.

      Hem düşük hem de yüksek alanları doldurulmalı, gösterilen kutu kullanılamaz boştur. 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 geri döndü. Bölgeyi dikdörtgen görünüm alanı olarak belirtin. Açıklamayı göster / locationBias bölümünü tanımlama hakkında bilgi edinin.

    locationRestriction veya locationBias, ancak her ikisi birden değil. locationRestriction, sonuçların içinde olması gereken bölge ve locationBias olarak sonuçların yakınında olması gereken ancak dışında olabilecek bölgeyi belirtmek inceleyeceğiz.

  • 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ğeri 5 olarak ayarlandığında 5 değeri döndürülür sonuçları ilk sayfada görebilirsiniz. Döndürülebilecek daha fazla sonuç varsa isterseniz yanıt, oluşturduğunuz bir nextPageToken bir sonraki sayfaya erişmek için sonraki bir isteğe iletebilir.

  • evOptions

    Mevcut elektrikli aracı (EV) tanımlamak için parametreleri belirtir şarj konnektörleri ve şarj etme hızları.

    • connectorTypes

      Bir yerde bulunan EV şarj konnektörünün türüne göre filtreler. CEVAP bağlayıcı türlerinden hiçbirini desteklemeyen yerler filtrelenir çıkar. Desteklenen EV şarj konnektörü türleri şunları içerir (AC ve DC) şarj cihazları, Tesla şarj cihazları, GB/T uyumlu şarj cihazları (EV hızlı şarj için Çin) ve duvar prizi şarj cihazları. Daha fazla bilgi için bkz. referans belgelerinden faydalanabilirsiniz.

    • minimumChargingRateKw

      Yerleri, kilovat (kW) cinsinden minimum EV şarj hızına göre filtreler. Herhangi biri minimum şarj hızının altında şarj olan yerler filtrelendi. Örneğin, elektrikli araç şarj istasyonlarını bulmak için en az 10 kW değerindeyse bu parametreyi "10" olarak ayarlayabilirsiniz.

  • minRating

    Sonuçları, yalnızca ortalama kullanıcı puanı şundan yüksek olanlarla kısıtlar: veya eşit olabilir. Değerler, 0,0 ile 5,0 (dahil) arasında olmalıdır 0,5'lik artışlar olacaktır. Örneğin: 0, 0,5, 1,0, ... , 5,0 dahil bu sayılar. Değerler 0,5'e yuvarlanır. Örneğin, 0,6 değeri, sonuç 1,0'ın altındadır.

  • openNow

    true ise yalnızca faaliyette olan yerleri döndürün sorgu gönderilir. false ise tüm işletmeleri döndürün açık durumundan bağımsız olarak sağlayın. Google Rehber veritabanında çalışma saatleri belirtilmeyen yerler bu parametreyi false olarak ayarlarsanız 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ğeri 5 olarak ayarlandığında 5 değeri döndürülür sonuçları ilk sayfada görebilirsiniz. Döndürülebilecek daha fazla sonuç varsa isterseniz yanıt, oluşturduğunuz bir nextPageToken bir sonraki sayfaya erişmek için sonraki bir isteğe iletebilir.

  • pageToken

    Yanıt gövdesindeki nextPageToken öğesini belirtir önceki sayfa.

  • priceLevels

    Aramayı belirli fiyat düzeylerinde işaretlenmiş yerlerle sınırlandırın. Varsayılan olarak tüm fiyat düzeyleri seçilir.

    Tanımlayıcılı olarak bir veya daha fazla değerden oluşan bir dizi belirtin: PriceLevel.

    Örneğin:

    "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]

  • rankPreference

    Sonuçların yanıtta türüne göre nasıl sıralandığını belirtir. sorgu:

    • "İstanbul'daki Restoranlar" gibi bir kategorik sorgu için RELEVANCE (sonuçları arama alaka düzeyine göre sıralama) varsayılan değerdir. rankPreference öğesini RELEVANCE olarak ayarlayabilir veya DISTANCE (sonuçları mesafeye göre sırala).
    • "Mountain View, CA" gibi kategorik olmayan bir sorgu için rankPreference politikasını ayarlamadan bırakın.

  • regionCode

    Yanıtı biçimlendirmek için kullanılan bölge kodu, CLDR kodu değerini girin. Bu parametrenin yanlılık etkisi de olabilir daha fazla bilgi edineceksiniz. Varsayılan bir değer yok.

    formattedAddress alanındaki ülke adı, yanıt regionCode ile eşleşirse, ülke kodu atlanır başlangıç fiyatı: formattedAddress. Bu parametrenin adrFormatAddress (her zaman ülkeyi içerir) varsa veya shortFormattedAddress üzerinde geçerli olacak, bunu içerir.

    Ç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.

  • strictTypeFiltering

    includedType parametresiyle kullanılır. Şuna ayarlandığında: true, yalnızca includeType döndürüldü. False (yanlış) değerine ayarlandığında varsayılan, yanıtta eşleşmeyen yerler olabilir belirtilen türlerde.

Metin Arama örnekleri

Sorgu dizesine göre yer bulma

Aşağıdaki örnekte şunun için bir Metin Arama isteği gösterilmektedir: "Avustralya, Sidney'de Acı Vejetaryen Yemek":

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 şu veri alanlarını içerir: 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, places.types,places.websiteUri restoran türünü ve web adresini yanıt:

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ı restoranlara göre filtrelemek için priceLevel seçeneğini kullanın. "Pahalı değil" veya "Kısmen pahalı" olarak tanımlanır:

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 places.priceLevel veri alanını yanıt Yani şu biçimdedir:

{
  "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, gibi ek seçenekler ekleyin minRating, rankPreference, openNow, ve İsteğe bağlı parametreler.

Bir bölgedeki yerleri arama

locationRestriction veya locationBias kullanın, seçeneğini kullanabilirsiniz. locationRestriction düşünün ve locationBias sonuçların yakın olması gereken ancak dışında olabileceği bölgeyi belirterek inceleyeceğiz.

Aşağıdaki örnekte şunun için bir Metin Arama isteği gösterilmektedir: "Acı Vejetaryen Yemek" bir noktaya en fazla 500 metre mesafede şehir merkezinde yer alır. Bu istek yalnızca şu sorgu için ilk 10 sonucu döndürür: açık olan yerlerle ilgili.

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.

minimumChargingRateKw ve connectorTypes özelliklerini kullanarak EV’nizle uyumlu şarj cihazları olan yerleri arayın.

Aşağıdaki örnekte Tesla ve J1772 tür 1 EV şarjı için yapılan bir istek gösterilmektedir Mountain View, Kaliforniya'da minimum 10 kW şarj hızına sahip konnektörler satın aldı. 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

Yapılacak sonuç sayısını belirtmek için pageSize parametresini kullanın sağlayabilir. Yanıt gövdesindeki nextPageToken parametresi sonraki çağrılarda kullanılabilecek bir jeton sağlar. Bu jeton sonuç.

Aşağıdaki örnekte "New York'ta pizza" isteği gösterilmektedir 5 ile sınırlı sonuç (sayfa başına):

 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"
}

Bir sonraki sonuç sayfasına erişmek için pageToken düğmesini kullanarak İstek gövdesindeki nextPageToken:

 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 sayesinde örnek isteklerde bulunabilirsiniz. hakkında da bilgi edineceksiniz.

  1. API simgesini, API Gezgini'ni genişletin. sekmesini tıklayın.

  2. İsteğe bağlı olarak Standart parametreleri göster seçeneğini genişletin ve fields parametresini alanına ekleyin hakkında daha fazla bilgi edinin.

  3. İsteğe bağlı olarak İstek gövdesini düzenleyin.

  4. Yürüt düğmesini seçin. Pop-up iletişim kutusundan kullanma konusunda karar vermemiz gerekir.

  5. API Gezgini panelinde genişlet simgesini seçin, API Gezgini penceresini genişletmek için API Gezgini'ni genişletin. tuşlarına basın.