快速入門：使用 Python 將搜尋要求傳送至 Bing 實體搜尋 REST API

使用本快速入門以第一次呼叫 Bing 實體搜尋 API，並檢視 JSON 回應。 這個簡單的 Python 應用程式會將新聞搜尋查詢傳送給 API，並顯示回應。 GitHub 上有此範例的原始程式碼。

雖然此應用程式是以 Python 撰寫的，但 API 是一種與大多數程式設計語言都相容的 RESTful Web 服務。

Prerequisites

• Python 2.x 或 3.x

建立 Azure 資源

藉由建立下列其中一項 Azure 資源，開始使用 Bing 實體搜尋 API。

Bing 實體搜尋資源

• 您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
• 使用免費定價層來試用服務，之後可升級至付費層以用於實際執行環境。
• Bing 實體搜尋也會在 Bing 搜尋 v7 資源的付費層中提供。

多服務資源

• 您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
• 針對您的應用程式，跨多個 Azure AI 服務使用相同的金鑰和端點。

建立應用程式並將其初始化

1. 在您慣用的 IDE 或編輯器中建立新的 Python 專案，以及新增下列匯入項目。 針對您的訂用帳戶金鑰、端點、市場和搜尋查詢建立變數。 您可以使用下列程式碼中的全域端點，或使用 Azure 入口網站中針對您的資源所顯示的自訂子網域端點。

   import http.client, urllib.parse
   import json
   
   subscriptionKey = 'ENTER YOUR KEY HERE'
   host = 'api.bing.microsoft.com'
   path = '/v7.0/search'
   mkt = 'en-US'
   query = 'italian restaurants near me'
   

2. 藉由將市場變數附加至 ?mkt= 參數來建立要求 url。 對查詢進行 Url 編碼，並將其附加至 &q= 參數。

   params = '?mkt=' + mkt + '&q=' + urllib.parse.quote (query)
   

傳送要求並取得回應

1. 建立稱為 get_suggestions() 的函式。

2. 在此函式中，使用 Ocp-Apim-Subscription-Key 作為金鑰，將訂用帳戶金鑰新增至字典中。

3. 使用 http.client.HTTPSConnection() 建立 HTTPS 用戶端物件。 使用 request() 與路徑和參數以及標頭資訊來傳送 GET 要求。

4. 使用 getresponse() 儲存回應，並傳回 response.read()。

   def get_suggestions ():
    headers = {'Ocp-Apim-Subscription-Key': subscriptionKey}
    conn = http.client.HTTPSConnection (host)
    conn.request ("GET", path + params, None, headers)
    response = conn.getresponse ()
    return response.read()
   

5. 呼叫 get_suggestions()，並列印 JOSN 回應。

   result = get_suggestions ()
   print (json.dumps(json.loads(result), indent=4))
   

範例 JSON 回應

如以下範例所示，成功的回應會以 JSON 格式來傳回：

{
  "_type": "SearchResponse",
  "queryContext": {
    "originalQuery": "italian restaurant near me",
    "askUserForLocation": true
  },
  "places": {
    "value": [
      {
        "_type": "LocalBusiness",
        "webSearchUrl": "https://www.bing.com/search?q=sinful+bakery&filters=local...",
        "name": "Liberty's Delightful Sinful Bakery & Cafe",
        "url": "https://www.contoso.com/",
        "entityPresentationInfo": {
          "entityScenario": "ListItem",
          "entityTypeHints": [
            "Place",
            "LocalBusiness"
          ]
        },
        "address": {
          "addressLocality": "Seattle",
          "addressRegion": "WA",
          "postalCode": "98112",
          "addressCountry": "US",
          "neighborhood": "Madison Park"
        },
        "telephone": "(800) 555-1212"
      },

      . . .
      {
        "_type": "Restaurant",
        "webSearchUrl": "https://www.bing.com/search?q=Pickles+and+Preserves...",
        "name": "Munson's Pickles and Preserves Farm",
        "url": "https://www.princi.com/",
        "entityPresentationInfo": {
          "entityScenario": "ListItem",
          "entityTypeHints": [
            "Place",
            "LocalBusiness",
            "Restaurant"
          ]
        },
        "address": {
          "addressLocality": "Seattle",
          "addressRegion": "WA",
          "postalCode": "98101",
          "addressCountry": "US",
          "neighborhood": "Capitol Hill"
        },
        "telephone": "(800) 555-1212"
      },
      
      . . .
    ]
  }
}

後續步驟

• 什麼是 Bing 實體搜尋 API？
• Bing 實體搜尋 API 參考。