Bu sayfa, Cloud Translation API ile çevrilmiştir.

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. Not: Telefon numarasında arama yaparken en iyi sonuçları elde etmek için ülke kodunu, ardından bir boşluk ekleyip `regionCode` parametresini ülke koduna karşılık gelecek şekilde ayarlayın.

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
```
Not: Alan listesinin hiçbir yerinde alanlara izin verilmez.

Tüm alanları almak için * öğesini kullanın.
```
X-Goog-FieldMask: *
```
Joker karakter "*" tüm alanları seçer. Bununla birlikte, bu joker karakter geliştirme aşamasında kullanılabilir ancak Google, döndürülebilecek büyük miktarda veri nedeniyle üretimde joker karakter (*) yanıt alanı maskesinin kullanılmasını önermez.

places.iconMaskBaseUri ve places.iconBackgroundColor öğelerinin kullanımıyla ilgili daha fazla bilgiyi Yer Simgeleri bölümünde bulabilirsiniz.

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"
Not: Tablo B'deki değerler yalnızca yanıtta döndürülür. Tablo B'deki değerleri filtre olarak kullanamazsınız.
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.

Not: locationBias ve locationRestriction değerlerini çıkarırsanız API varsayılan olarak IP'ye ağırlık vermeyi kullanır. IP'ye ağırlık verme ile API, sonuçlara ağırlık vermek için cihazın IP adresini kullanır.

Not: textQuery, Market in Barcelona gibi açık bir konum içeriyorsa locationBias parametresi geçersiz kılınabilir. Bu durumda locationBias yoksayılır.

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.

Not: locationBias ve locationRestriction değerlerini çıkarırsanız API varsayılan olarak IP'ye ağırlık vermeyi kullanır. IP'ye ağırlık verme ile API, sonuçlara ağırlık vermek için cihazın IP adresini kullanır.
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.

Not: PRICE_LEVEL_FREE öğesine bir istekte izin verilmez. Yalnızca yanıtı doldurmak için kullanılır.

Örneğin:
```
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
```
rankPreference

Sonuçların sorgu türüne göre yanıtta nasıl sıralandığını belirtir:
- "İstanbul'daki restoranlar" gibi kategorik bir sorgu için RELEVANCE (sonuçları arama alaka düzeyine göre sıralar) varsayılan değerdir. rankPreference değerini RELEVANCE veya DISTANCE olarak ayarlayabilirsiniz (sonuçları mesafeye göre sıralayın).
- "Mountain View, CA" gibi kategorik olmayan bir sorgu için rankPreference parametresini ayarlamadan bırakmanızı öneririz.
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.

Not: locationBias kullanırken bölgeyi dikdörtgen Görünüm veya daire olarak belirtebilirsiniz. locationRestriction için, bölgeyi dikdörtgen Görüntü Alanı olarak belirtebilirsiniz.

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.

Sayfanın sağ tarafındaki API simgesini seçin.
İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresini alan maskesine ayarlayın.
İsteğe bağlı olarak İstek gövdesi'ni düzenleyin.
Yürüt düğmesini seçin. Pop-up iletişim kutusunda, istekte bulunurken kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde API Gezgini penceresini genişletmek için genişletme simgesini () seçin.

Metin Arama (Yeni)

Metin Arama istekleri

Metin Arama (Yeni) yanıtları

Gerekli parametreler

FieldMask

textQuery

İsteğe bağlı parametreler

includedType

languageCode

locationBias

locationRestriction

maxResultCount

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

priceLevels

rankPreference

regionCode

strictTypeFiltering

Metin Arama örnekleri

Sorgu dizesine göre yer bul

Yerleri fiyat düzeyine göre filtrele

Bir bölgedeki yerleri arama

Minimum şarj hızına sahip EV şarj cihazlarını arayın

Deneyin.