Merge pull request #114847 from dksimpson/DKS-US1712683-bing-local-business-search

Refresh Bing Local Business Search REST API quickstarts

Author: denrea

articles/cognitive-services/bing-local-business-search/quickstarts/local-quickstart.md

@@ -8,26 +8,25 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-local-business
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/12/2020
 ms.author: aahi
 ---
 
 # Quickstart: Send a query to the Bing Local Business Search API in C#
 
-Use this quickstart to begin sending requests to the Bing Local Business Search API, which is an Azure Cognitive Service. While this simple application is written in C#, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
+Use this quickstart to learn how to send requests to the Bing Local Business Search API, which is an Azure Cognitive Service. Although this simple application is written in C#, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
 
-This example application gets local response data from the API for the search query `hotel in Bellevue`.
+This example application gets local response data from the API for a search query.
 
 ## Prerequisites
 
 * Any edition of [Visual Studio 2019](https://www.visualstudio.com/downloads/).
-* If you are using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
-
-You must have a [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing Search APIs. The [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient for this quickstart.  See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
+* If you're using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
+* A [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing Search APIs. For this quickstart, the [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient. Save the API key that's provided when you activate your free trial. For more information, see [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
 
 ## Create the request 
 
-The following code creates a `WebRequest`, sets the access key header, and adds a query string for "restaurant in Bellevue".  It then sends the request and assigns the response to a string to contain the JSON text.
+The following code creates a `WebRequest`, sets the access key header, and adds a query string for *restaurant in Bellevue*.  It then sends the request and assigns the response to a string to contain the JSON text.
 
 ```csharp
     // Replace the accessKey string value with your valid access key.
@@ -49,10 +48,10 @@ The following code creates a `WebRequest`, sets the access key header, and adds
 
 ## Run the complete application
 
-The Bing Local Business Search API returns localized search results from the Bing search engine.
-1. Create a new Console solution in Visual Studio (the Community Edition is fine).
+The following code uses the Bing Local Business Search API to return localized search results from the Bing search engine. You can use this code by following these steps:
+1. Create a new console solution in Visual Studio (the Community Edition is sufficient).
 2. Replace Program.cs with the code provided below.
-3. Replace the accessKey value with an access key valid for your subscription.
+3. Replace the `accessKey` value with an access key valid for your subscription.
 4. Run the program.
 
 ```csharp
@@ -205,5 +204,5 @@ namespace localSearch
 
 ## Next steps
 - [Local Business Search Java quickstart](local-search-java-quickstart.md)
-- [Local Business Search Node quickstart](local-search-node-quickstart.md)
+- [Local Business Search Node.js quickstart](local-search-node-quickstart.md)
 - [Local Business Search Python quickstart](local-search-python-quickstart.md)

articles/cognitive-services/bing-local-business-search/quickstarts/local-search-java-quickstart.md

@@ -8,27 +8,25 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-local-business
 ms.topic: quickstart
-ms.date: 11/29/2019
+ms.date: 05/12/2020
 ms.author: aahi
 ---
 
 # Quickstart: Send a query to the Bing Local Business Search API using Java
 
-Use this quickstart to begin sending requests to the Bing Local Business Search API, which is an Azure Cognitive Service. While this simple application is written in Java, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
+Use this quickstart to learn how to send requests to the Bing Local Business Search API, which is an Azure Cognitive Service. Although this simple application is written in Java, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
 
-This example application gets local response data from the API for the search query `hotel in Bellevue`.
+This example application gets local response data from the API for a search query.
 
 ## Prerequisites
 
-* The [Java Development Kit(JDK)](https://www.oracle.com/technetwork/java/javase/downloads/index.html)
+* The [Java Development Kit (JDK)](https://www.oracle.com/technetwork/java/javase/downloads/index.html).
+* A [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing Search APIs. For this quickstart, the [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient. Save the API key that's provided when you activate your free trial. For more information, see [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
 
-You must have a [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing Search APIs. The [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient for this quickstart. You will need the access key provided when you activate your free trial.  See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
-
-This example application gets local response data from the query for a *hotel in Bellevue*.
 
 ## Create the request 
 
-The following code creates a `WebRequest`, sets the access key header, and adds a query string for "hotel in Bellevue".  It then sends the request and assigns the response to a string to contain the JSON text.
+The following code creates a `WebRequest`, sets the access key header, and adds a query string for *hotel in Bellevue*.  It then sends the request and assigns the response to a string to contain the JSON text.
 
 ```java
     // construct URL of search request (endpoint + query string)
@@ -46,11 +44,11 @@ The following code creates a `WebRequest`, sets the access key header, and adds
 
 ## Run the complete application
 
-The Bing Local Business Search API returns results from the Bing search engine.
+The following code uses the Bing Local Business Search API to return search results from the Bing search engine. Run this code by following these steps:
 1. Download or install the gson library.
 2. Create a new Java project in your favorite IDE or editor.
 3. Add the code provided below.
-4. Replace the subscriptionKey value with an access key valid for your subscription.
+4. Replace the `subscriptionKey` value with an access key valid for your subscription.
 5. Run the program.
 
 ```java
@@ -160,6 +158,6 @@ public class LocalSearchCls {
 ```
 
 ## Next steps
-- [Local Business Search quickstart](local-quickstart.md)
-- [Local Business Search Node quickstart](local-search-node-quickstart.md)
+- [Local Business Search C# quickstart](local-quickstart.md)
+- [Local Business Search Node.js quickstart](local-search-node-quickstart.md)
 - [Local Business Search Python quickstart](local-search-python-quickstart.md)

articles/cognitive-services/bing-local-business-search/quickstarts/local-search-node-quickstart.md

@@ -8,35 +8,33 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-local-business
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/12/2020
 ms.author: aahi
 ---
 
 # Quickstart: Send a query to the Bing Local Business Search API using Node.js
 
-Use this quickstart to begin sending requests to the Bing Local Business Search API, which is an Azure Cognitive Service. While this simple application is written in Node.js, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
+Use this quickstart to learn how to send requests to the Bing Local Business Search API, which is an Azure Cognitive Service. Although this simple application is written in Node.js, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
 
-This example application gets local response data from the API for the search query `hotel in Bellevue`.
+This example application gets local response data from the API for a search query.
 
 ## Prerequisites
 
 * The latest version of [Node.js](https://nodejs.org/en/download/).
+* The [JavaScript Request Library](https://github.com/request/request).
+* A [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing Search APIs. For this quickstart, the [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient. Save the API key that's provided when you activate your free trial. For more information, see [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
 
-* The [JavaScript Request Library](https://github.com/request/request)
-
-You must have a [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing APIs. The [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient for this quickstart. Use the access key provided by the free trial.  See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
 
 ## Code scenario
 
-The following code gets defines and sends the request. It is implemented in the following steps:
+The following code defines and sends the request, which is implemented in the following steps:
 
 1. Declare variables to specify the endpoint by host and path.
 2. Specify the query, and add the query parameter.
 3. Create a handler function for the response.
-4. Define the Search function that creates the request and adds the Ocp-Apim-Subscription-Key header.
-5. Run the Search function.
+4. Define the Search function that creates the request and adds the `Ocp-Apim-Subscription-Key` header.
+5. Run the search function.
 
-The complete code for this demo follows:
 
 ```javascript
 'use strict';
@@ -89,6 +87,6 @@ Search();
 
 ## Next steps
 
-* [Local Business Search quickstart](local-quickstart.md)
+* [Local Business Search C# quickstart](local-quickstart.md)
 * [Local Business Search Java quickstart](local-search-java-quickstart.md)
 * [Local Business Search Python quickstart](local-search-python-quickstart.md)

articles/cognitive-services/bing-local-business-search/quickstarts/local-search-python-quickstart.md

@@ -8,32 +8,31 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-local-business
 ms.topic: quickstart
-ms.date: 11/29/2019
+ms.date: 05/12/2020
 ms.author: aahi
 ---
 # Quickstart: Send a query to the Bing Local Business Search API in Python
 
-Use this quickstart to begin sending requests to the Bing Local Business Search API, which is an Azure Cognitive Service. While this simple application is written in Python, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
+Use this quickstart to learn how to send requests to the Bing Local Business Search API, which is an Azure Cognitive Service. Although this simple application is written in Python, the API is a RESTful Web service compatible with any programming language capable of making HTTP requests and parsing JSON.
 
-This example application gets local response data from the API for the search query `hotel in Bellevue`.
+This example application gets local response data from the API for a search query.
 
 ## Prerequisites
 
-* [Python](https://www.python.org/) 2.x or 3.x
- 
-You must have a [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing APIs. The [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient for this quickstart. Use the access key provided by the free trial.  See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
+* [Python](https://www.python.org/) 2.x or 3.x.
+* A [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing Search APIs. For this quickstart, the [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) is sufficient. Save the API key that's provided when you activate your free trial. For more information, see [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
 
 ## Run the complete application
 
-The following code gets localized results. It is implemented in the following steps:
+The following example gets localized results, which are implemented in the following steps:
 1. Declare variables to specify the endpoint by host and path.
 2. Specify the query parameter. 
-3. Define the Search function that creates the request and adds the Ocp-Apim-Subscription-Key header.
-4. Set the Ocp-Apim-Subscription-Key header. 
+3. Define the search function that creates the request and adds the `Ocp-Apim-Subscription-Key` header.
+4. Set the `Ocp-Apim-Subscription-Key` header. 
 5. Make the connection and send the request.
 6. Print the JSON results.
 
-The complete code for this demo follows:
+The complete code for this demo is as follows:
 
 ```python
 import http.client, urllib.parse
@@ -62,6 +61,6 @@ print (json.dumps(json.loads(result), indent=4))
 ```
 
 ## Next steps
-- [Local Business Search Java Quickstart](local-search-java-quickstart.md)
-- [Local Business Search C# Quickstart](local-quickstart.md)
-- [Local Business Search Node Quickstart](local-search-node-quickstart.md)
+- [Local Business Search Java quickstart](local-search-java-quickstart.md)
+- [Local Business Search C# quickstart](local-quickstart.md)
+- [Local Business Search Node.js quickstart](local-search-node-quickstart.md)

articles/cognitive-services/bing-local-business-search/toc.yml

@@ -19,7 +19,7 @@
         href: quickstarts/local-quickstart.md 
       - name: Using Java 
         href: quickstarts/local-search-java-quickstart.md 
-      - name: Using Node 
+      - name: Using Node.js 
         href: quickstarts/local-search-node-quickstart.md 
       - name: Using Python 
         href: quickstarts/local-search-python-quickstart.md