You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-maps/how-to-search-for-address.md
+19-11Lines changed: 19 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,11 @@ This article demonstrates how to:
26
26
* An [Azure Maps account]
27
27
* A [subscription key]
28
28
29
-
This tutorial uses the [Postman] application, but you may choose a different API development environment.
29
+
>[!IMPORTANT]
30
+
>
31
+
> In the URL examples in this article you will need to replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key.
32
+
33
+
This article uses the [bruno] application, but you can choose a different API development environment.
30
34
31
35
## Request latitude and longitude for an address (geocoding)
32
36
@@ -35,23 +39,27 @@ The example in this section uses [Get Search Address] to convert an address into
35
39
>[!TIP]
36
40
>If you have a set of addresses to geocode, you can use [Post Search Address Batch] to send a batch of queries in a single request.
37
41
38
-
1.In the Postman app, select **New** to create the request. In the **Create New** window, select**HTTP Request**. Enter a **Request name** for the request.
42
+
1.Open the bruno app, select **NEW REQUEST** to create the request. In the **NEW REQUEST** window, set**Type** to **HTTP**. Enter a **Name** for the request.
39
43
40
-
2. Select the **GET** HTTP method in the builder tab and enter the following URL. In this request, we're searching for a specific address: `400 Braod St, Seattle, WA 98109`. For this request, and other requests mentioned in this article, replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key.
44
+
1. Select the **GET** HTTP method in the **URL** drop-down list, then enter the following URL:
41
45
42
46
```http
43
47
https://atlas.microsoft.com/search/address/json?&subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&language=en-US&query=400 Broad St, Seattle, WA 98109
44
48
```
45
49
46
-
3. Select the blue **Send** button. The response body contains data for a single location.
50
+
This request searches for a specific address: `400 Broad St, Seattle, WA 98109`.
51
+
52
+
1. Select the **Create** button.
53
+
54
+
1. Select the run button.
47
55
48
-
4. Next, search an address that has more than one possible locations. In the **Params** section, change the `query` key to `400 Broad, Seattle`. Select the blue **Send** button.
56
+
1. Next, search an address that has more than one possible location. In the **Params** section, change the `query` key to `400 Broad, Seattle`. Select the blue **Send** button.
49
57
50
58
:::image type="content" source="./media/how-to-search-for-address/search-address.png" alt-text="Search for address":::
51
59
52
-
5. Next, try setting the `query` key to `400 Broa`.
60
+
1. Next, try setting the `query` key to `400 Broa`.
53
61
54
-
6. Select the **Send** button. The response includes results from multiple countries/regions. To geobias results to the relevant area for your users, always add as many location details as possible to the request.
62
+
1. Select the **Send** button. The response includes results from multiple countries/regions. To geobias results to the relevant area for your users, always add as many location details as possible to the request.
55
63
56
64
## Fuzzy Search
57
65
@@ -67,7 +75,7 @@ The example in this section uses `Fuzzy Search` to search the entire world for *
67
75
> [!IMPORTANT]
68
76
> To geobias results to the relevant area for your users, always add as many location details as possible. For more information, see [Best Practices for Search].
69
77
70
-
1. In the Postman app, select **New** to create the request. In the **Create New** window, select **HTTP Request**. Enter a **Request name** for the request.
78
+
1. Open the bruno app, select **NEW REQUEST** to create the request. In the **NEW REQUEST** window, set **Type** to **HTTP**. Enter a **Name** for the request.
71
79
72
80
2. Select the **GET** HTTP method in the builder tab and enter the following URL. For this request, and other requests mentioned in this article, replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key.
73
81
@@ -115,7 +123,7 @@ The example in this section uses `Fuzzy Search` to search the entire world for *
115
123
116
124
This example demonstrates making reverse searches using a few of the optional parameters that are available. For the full list of optional parameters, see [Reverse Search Parameters].
117
125
118
-
1. In the Postman app, select **New** to create the request. In the **Create New** window, select **HTTP Request**. Enter a **Request name** for the request.
126
+
1. Open the bruno app, select **NEW REQUEST** to create the request. In the **NEW REQUEST** window, set **Type** to **HTTP**. Enter a **Name** for the request.
119
127
120
128
2. Select the **GET** HTTP method in the builder tab and enter the following URL. For this request, and other requests mentioned in this article, replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key. The request should look like the following URL:
121
129
@@ -151,7 +159,7 @@ This example demonstrates making reverse searches using a few of the optional pa
151
159
152
160
This example demonstrates how to search for a cross street based on the coordinates of an address.
153
161
154
-
1. In the Postman app, select **New** to create the request. In the **Create New** window, select **HTTP Request**. Enter a **Request name** for the request.
162
+
1. Open the bruno app, select **NEW REQUEST** to create the request. In the **NEW REQUEST** window, set **Type** to **HTTP**. Enter a **Name** for the request.
155
163
156
164
2. Select the **GET** HTTP method in the builder tab and enter the following URL. For this request, and other requests mentioned in this article, replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key. The request should look like the following URL:
157
165
@@ -183,7 +191,7 @@ This example demonstrates how to search for a cross street based on the coordina
183
191
[point of interest result]: /rest/api/maps/search/getsearchpoi?view=rest-maps-1.0&preserve-view=true#searchpoiresponse
0 commit comments