Bing Yerel İş Arama API'sini gönderme ve kullanma sorguları ve yanıtları

Makale
06/26/2018

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Bing Yerel İş Arama API'sinden, uç noktasına bir arama sorgusu göndererek ve gerekli olan üst bilgiyi ekleyerek Ocp-Apim-Subscription-Key yerel sonuçlar alabilirsiniz. Kullanılabilir üst bilgiler ve parametrelerle birlikte, aranacak alan için coğrafi sınırlar ve döndürülen yer kategorileri belirtilerek Aramalar özelleştirilebilir.

İstek oluşturma

Bing Yerel İş Arama API'sine istek göndermek için, API uç noktasına eklemeden önce parametreye q= bir arama terimi ekleyin ve üst bilgiyi ekleyin Ocp-Apim-Subscription-Key . Örnek:

https://api.cognitive.microsoft.com/bing/localbusinesses/v7.0/search?q=restaurant+in+Bellevue

tam istek URL'si söz dizimi aşağıda gösterilmiştir. İstek gönderme hakkında daha fazla bilgi için bkz. Bing Yerel İş Arama API'sinin hızlı başlangıçları ve üst bilgiler ve parametreler için başvuru içeriği.

Yerel arama kategorileri hakkında daha fazla bilgi için bkz. Bing Yerel İş Arama API'sinin arama kategorileri.

https://api.cognitive.microsoft.com/bing/v7.0/localbusinesses/search[?q][&localCategories][&cc][&mkt][&safesearch][&setlang][&count][&first][&localCircularView][&localMapView]

Yanıtları kullanma

Bing Yerel İş Arama API'sinden gelen JSON yanıtları bir SearchResponse nesne içerir. API, alana ilgili arama sonuçlarını places döndürür. sonuç bulunamazsa, places alan yanıta dahil edilmeyecektir.

Not

URL biçimleri ve parametreleri önceden haber veremeden değiştirilebilir olduğundan, tüm URL'leri olduğu gibi kullanın. Url biçimine veya parametrelere bağımlılıkları not edilen durumlar dışında almamalısınız.

{
   "_type": "SearchResponse",
   "queryContext": {
      "originalQuery": "restaurant in Bellevue"
   },
   "places": {
      "totalEstimatedMatches": 10,
. . .

Arama sonucu öznitelikleri

API tarafından döndürülen JSON sonuçları aşağıdaki öznitelikleri içerir:

_Türü
adres
entityPresentationInfo
coğrafi bölge
kimlik
name
routeablePoint
Telefon
url

Üst bilgiler, parametreler, pazar kodları, yanıt nesneleri, hatalar vb. hakkında genel bilgi için bkz. Bing Yerel Arama API'si v7 başvurusu.

Not

Siz veya sizin adınıza üçüncü bir taraf, Yerel Arama API'sinden herhangi bir veriyi Test etme, geliştirme, eğitme, dağıtma veya Microsoft dışı herhangi bir hizmet veya özelliği kullanıma sunma amacıyla kullanamaz, saklayameyebilir, önbelleğe alamayabilir, paylaşameyebilir veya dağıtamayın.

Örnek JSON yanıtı

Aşağıdaki JSON yanıtı, sorgusu ?q=restaurant+in+Bellevuetarafından belirtilen arama sonuçlarını içerir.

Vary: Accept-Encoding
BingAPIs-TraceId: 5376FFEB65294E24BB9F91AD70545826
BingAPIs-SessionId: 06ED7CEC80F746AA892EDAAC97CB0CB4
X-MSEdge-ClientID: 112C391E72C0624204153594738C63DE
X-MSAPI-UserState: aeab
BingAPIs-Market: en-US
X-Search-ResponseInfo: InternalResponseTime=659,MSDatacenter=CO4
X-MSEdge-Ref: Ref A: 5376FFEB65294E24BB9F91AD70545826 Ref B: BY3EDGE0306 Ref C: 2018-10-16T16:26:15Z
apim-request-id: fe54f585-7c54-4bf5-8b92-b9bede2b710a
Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
Cache-Control: max-age=0, private
Date: Tue, 16 Oct 2018 16:26:15 GMT
P3P: CP="NON UNI COM NAV STA LOC CURa DEVa PSAa PSDa OUR IND"
Content-Length: 978
Content-Type: application/json; charset=utf-8
Expires: Tue, 16 Oct 2018 16:25:15 GMT

{
  "_type": "SearchResponse",
  "queryContext": {
    "originalQuery": "restaurant Bellevue"
  },
  "places": {
    "totalEstimatedMatches": 50,
    "value": [{
      "_type": "LocalBusiness",
      "id": "https:\/\/cognitivegblppe.azure-api.net\/api\/v7\/#Places.0",
      "name": "Facing East Taiwanese Restaurant",
      "url": "http:\/\/litadesign.wix.com\/facingeastrestaurant",
      "entityPresentationInfo": {
        "entityScenario": "ListItem",
        "entityTypeHints": ["Place", "LocalBusiness", "Restaurant"]
      },
      "geo": {
        "latitude": 47.6199188232422,
        "longitude": -122.202796936035
      },
      "routablePoint": {
        "latitude": 47.6199188232422,
        "longitude": -122.201713562012
      },
      "address": {
        "streetAddress": "1075 Bellevue Way NE Ste B2",
        "addressLocality": "Bellevue",
        "addressRegion": "WA",
        "postalCode": "98004",
        "addressCountry": "US",
        "neighborhood": "Bellevue",
        "text": "1075 Bellevue Way NE Ste B2, Bellevue, WA 98004"
      },
      "telephone": "(425) 688-2986"
    }],
    "searchAction": {
      "location": [{
        "name": "Bellevue, Washington"
      }],
      "query": "restaurant"
    }
  }
}

İstekleri azaltma

Saniye başına yapabileceğiniz sorgu sayısı (QPS), hizmete ve aboneliğinizin türüne göre belirlenir. Uygulamanızın, kotanızın sınırları içinde kalmak için gereken mantığı içerdiğinden emin olun. QPS sınırına ulaşılırsa veya bu sınır aşılırsa istek başarısız olur ve HTTP 429 durum kodu döndürülür. Yanıt, başka bir istek göndermeden önce beklemeniz gereken süreyi gösteren Retry-After üst bilgisini içerir.

Hizmet reddi ile azaltma karşılaştırması

Hizmette, hizmet reddi (DoS) saldırısıyla QPS ihlali arasında bir ayrım yapılır. Hizmet bir DoS saldırısı olduğundan şüphelenirse istek başarılıyla sonuçlanır (HTTP durum kodu 200 TAMAM). Ancak, yanıt gövdesi boş olur.

Share via