Metin Arama (Yeni)

Metin Arama (Yeni), bir dizeye dayalı olarak bir dizi yer hakkında bilgi döndürür; örneğin, "İstanbul'da pizza" veya "Taksim yakınındaki ayakkabı mağazaları" ya da "Ana Cadde No: 123.". Hizmet, metin dizesiyle eşleşen yerlerin ve ayarlanan konum önyargılarının bir listesiyle yanıt verir.

Hizmet, özellikle otomatik bir sistemde belirsiz adres sorguları oluşturmak için yararlıdır ve dizenin adres olmayan bileşenleri, işletmelerle ve adreslerle 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 tablodaki ilk iki örnekte olduğu gibi istekler, bir konum (ör. bölge, konum kısıtlaması veya konum önyargısı) ayarlanmamışsa sıfır sonuç döndürebilir.

"Taksim Mahallesi, Hasbahçe Sokak, Üsküdar, 34110" İngiltere'de birden fazla "High Street", ABD'de birden fazla "Ana Cadde". Sorgu, konum kısıtlaması ayarlanmadıkça istenen sonuçları döndürmüyor.
"ZincirRestoran İstanbul" New York'ta birden fazla "ChainRestaurant" konumu; açık adres, hatta sokak adı yok.
"10. Cadde, Escher UK" veya "123 Main Street, Pleasanton ABD" İngiltere'nin Escher şehrinde yalnızca bir "High Street"; ABD'nin Pleasanton CA şehrinde yalnızca bir "Ana Cadde".
"BenzersizRestoranAdi İstanbul" New York'ta bu ada sahip yalnızca bir işletme; ayırt etmek için açık adres gerekmez.
"İstanbul'daki pizza restoranları" Bu sorgu, konum kısıtlamasını içeriyor ve "pizza restoranları" iyi tanımlanmış bir yer türüdür. Birden çok 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'yi ve API seçeneklerini tanımanız için canlı isteklerde bulunmanıza olanak tanır:

Deneyin.

Metin Arama istekleri

Metin Arama isteği, aşağıdaki biçimdeki bir HTTP POST isteğidir:

https://places.googleapis.com/v1/places:searchText

Tüm parametreleri, JSON istek gövdesinde veya POST isteğinin bir parçası olarak başlıklarda geçirin. Ö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çeriyor.
  • 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ı şu 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 veya fields URL parametresini ya da X-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: 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.id, places.name*

      * places.name alanı, kaynak adı alanını şu biçimde içerir: places/PLACE_ID. Yerin metin adına erişmek için places.displayName öğesini 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.reservable, places.restroom places.reviews, places.curbsidePickup places.reviews, places.curbsidePickup places.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
  • textQuery

    Aranacak metin dizesi. Örneğin: "restoran", "Ana Cadde No: 123" veya "İstanbul'da ziyaret edilecek en iyi yer". API, bu dizeye göre aday eşleşmeleri döndürür ve sonuçları algılanan alaka düzeylerine 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 olmayabilir.
    • languageCode belirtilmezse API varsayılan olarak en olur. Geçersiz bir dil kodu belirtirseniz API INVALID_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.
  • locationBias

    Aranacak alanı belirtir. Bu konum bir ön yargı görevi görür. Yani belirtilen alanın dışındaki sonuçlar da dahil olmak üzere, belirtilen konumun çevresindeki sonuçların döndürülebileceği anlamına gelir.

    locationRestriction veya locationBias değerlerini belirtebilirsiniz, ancak ikisini birden belirtemezsiniz. locationRestriction özelliğini sonuçların içinde olması gereken bölgeyi, locationBias de sonuçların yakınında olması gereken ancak alanın dışında da olabileceği bölgeyi belirtmek olarak düşünün.

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

    • Bir daire, merkez noktası ve yarıçapıyla metre cinsinden tanımlanır. Yarıçap 0,0 ile 50000,0 (her iki değer 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, düşük ve yüksek noktaların çapraz olarak karşısında iki nokta olarak gösterilen 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ı bir bölge olarak kabul edilir, yani sınırlarını içerir. Enlem sınırları -90 ile 90 derece dahil, boylam sınırları ise -180 ile 180 derece (bu değerler dahil) arasında olmalıdır:

      • low = high ise görüntü alanı o tek noktadan oluşur.
      • low.longitude > high.longitude ise boylam aralığı ters çevrilir (görüntü alanı, 180 derecelik boylam çizgisini geçer).
      • low.longitude = -180 derece ve high.longitude = 180 dereceyse görüntü alanı tüm boylamları içerir.
      • low.longitude = 180 derece ve high.longitude = -180 derece ise boylam aralığı boş olur.
      • low.latitude > high.latitude ise enlem aralığı boştur.

      Hem düşük hem de yüksek doldurulmalıdır ve temsil edilen kutu boş olamaz. Boş görüntü alanı hataya neden olur.

      Örneğin, bu görünüm 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 olarak belirtin. Görünümü tanımlamayla ilgili bilgi edinmek için locationBias açıklamasına göz atın.

    locationRestriction veya locationBias değerlerini belirtebilirsiniz, ancak ikisini birden belirtemezsiniz. locationRestriction özelliğini sonuçların içinde olması gereken bölgeyi, locationBias de sonuçların yakınında olması gereken ancak alanın dışında da olabileceği bölgeyi belirtmek olarak düşünün.

  • maxResultCount

    Döndürülecek maksimum yer sonucu sayısını belirtir. 1 ile 20 (varsayılan) arasında olmalıdır.

  • evOptions

    Mevcut elektrikli araç (EV) şarj konnektörlerini ve şarj oranlarını tanımlamak için parametreleri belirtir.

    • connectorTypes

      Bir yerdeki EV şarj konnektörü 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 birleşik (AC ve DC) şarj cihazları, Tesla şarj cihazları, GB/T uyumlu şarj cihazları (Çin'de EV hızlı şarj cihazları için) ve duvar prizi şarj cihazları bulunur. Daha fazla bilgi için referans belgelerini inceleyin.

    • minimumChargingRateKw

      Yerleri kilovat (kW) cinsinden minimum EV şarj hızına göre filtreler. Şarj etme hızı, minimum şarj oranının altında olan yerler filtrelenir. Örneğin, şarj hızı en az 10 kW olan 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. Değerler en yakın 0,5'e yuvarlanır. Örneğin, 0,6 değeri 1,0'dan küçük bir puana sahip tüm sonuçları eler.

  • openNow

    true ise yalnızca sorgu gönderildiği sırada açık olan yerleri döndürür. false ise açık durumundan bağımsız olarak tüm işletmeleri iade edin. Bu parametreyi false olarak ayarlarsanız Google Rehber veritabanında çalışma saatleri belirtilmeyen yerler döndürülür.

  • priceLevels

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

    PriceLevel tarafından 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 yanıtta nasıl sıralandığını belirtir. API, geçerli olduğunda varsayılan olarak RELEVANCE kullanır. Örneğin, "İstanbul'daki restoranlar" gibi bir sorgu için RELEVANCE varsayılan değerdir. "Mountain View, CA" gibi coğrafi sorgular veya diğer sorgu türleri için hiçbir varsayılan değer uygulanmaz ve sonuçlar, arka uçta döndürülen sırayla gösterilir.

    Olası değerlere örnekler:

    • DISTANCE: Sonuçları mesafeye göre sıralayın.
    • RELEVANCE: Sonuçları alaka düzeyine göre sıralayın.
  • regionCode

    Yanıtı biçimlendirmek için kullanılan, iki karakterli CLDR kodu değeri olarak belirtilen bölge kodu. Bu parametrenin arama sonuçları üzerinde de önyargı etkisi olabilir. Varsayılan değer yoktur.

    Yanıttaki formattedAddress alanının ülke adı regionCode ile eşleşirse ülke kodu formattedAddress özelliğinden çıkarılır. Bu parametrenin, mevcut olduğunda ülke adını her zaman içeren adrFormatAddress veya hiçbir zaman içermeyen shortFormattedAddress ü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.

  • strictTypeFiltering

    includeType parametresiyle kullanılır. true olarak ayarlandığında, yalnızca includeType tarafından belirtilen türlerle eşleşen yerler döndürülür. Yanlış değerine ayarlanırsa yanıt, belirtilen türlerle eşleşmeyen yerler içerebilir.

Metin Arama örnekleri

Sorgu dizesine göre yer bul

Aşağıdaki örnekte "Avustralya, Sydney'de 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 üst bilgisi, yanıtın aşağıdaki veri alanlarını içerdiğini belirtir: places.displayName,places.formattedAddress. Ardından 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, restoran türünü ve web adresini yanıta eklemek 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 şu biçimdedir:

{
  "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ı "ucuz veya orta derecede 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, places.priceLevel veri alanını yanıta eklemek için X-Goog-FieldMask üst bilgisi kullanılmıştır. Dolayısıyla, aşağıdaki form şu şekildedir:

{
  "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 özelliğini sonuçların içinde olması gereken bölgeyi, locationBias ise sonuçların yakınında olması gereken ancak alanın dışında da bulunabilecek bölgeyi belirtir.

Aşağıdaki örnekte, San Francisco şehir merkezinde bir noktaya 500 metre mesafede olacak şekilde ağırlıklandırılmış "Acılı Vejetaryen Yemekler" 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,
  "maxResultCount": 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 cihazları olan 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 tip 1 EV şarj konnektörleri için talep gösterilmektedir. Yalnızca dört sonuç döndürülür.

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "maxResultCount": 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
          }
        ]
      }
    }
  ]
}

Deneyin.

API Explorer, API'yi ve API seçeneklerini tanımanız için örnek isteklerde bulunmanıza olanak tanır.

  1. İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresini alan maskesine ayarlayın.

  2. İsteğe bağlı olarak İstek gövdesi'ni düzenleyin.

  3. Yürüt düğmesini seçin. Pop-up iletişim kutusunda, istekte bulunurken kullanmak istediğiniz hesabı seçin.