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/glossary.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -151,6 +151,8 @@ The following list describes common words used with the Azure Maps services.
151
151
152
152
## G
153
153
154
+
<aname="geobias"></a> **Geobias**: A geospatial bias to improve the ranking of results. In some methods, this can be affected by setting the lat and lon parameters where available. In other cases it is purely internal.
155
+
154
156
<aname="geocode"></a> **Geocode**: An address or location that has been converted into a coordinate that can be used to display that location on a map.
155
157
156
158
<aname="geocoding"></a> **Geocoding**: Or _forward geocoding_, is the process of converting address of location data into coordinates.
Copy file name to clipboardExpand all lines: articles/azure-maps/how-to-search-for-address.md
+34-35Lines changed: 34 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,8 +36,8 @@ This article uses the [bruno] application, but you can choose a different API de
36
36
37
37
The example in this section uses [Get Search Address] to convert an address into latitude and longitude coordinates. This process is also called *geocoding*. In addition to returning the coordinates, the response also returns detailed address properties such as street, postal code, municipality, and country/region information.
38
38
39
-
>[!TIP]
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.
39
+
>[!TIP]
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.
41
41
42
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.
43
43
@@ -47,23 +47,23 @@ The example in this section uses [Get Search Address] to convert an address into
47
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
48
48
```
49
49
50
-
This request searches for a specific address: `400 Broad St, Seattle, WA 98109`.
51
-
52
50
1. Select the **Create** button.
53
51
54
52
1. Select the run button.
55
53
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.
54
+
This request searches for a specific address: `400 Broad St, Seattle, WA 98109`. Next, search an address that has more than one possible location.
55
+
56
+
1. In the **Params** section, change the `query` key to `400 Broad, Seattle`, then select the run button.
57
57
58
58
:::image type="content" source="./media/how-to-search-for-address/search-address.png" alt-text="Search for address":::
59
59
60
-
1. Next, try setting the `query` key to `400 Broa`.
60
+
1. Next, try setting the `query` key to `400 Broa`, then select the run button.
61
61
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.
62
+
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.
63
63
64
64
## Fuzzy Search
65
65
66
-
[Fuzzy Search] supports standard single line and free-form searches. We recommend that you use the Azure Maps Search Fuzzy API when you don't know your user input type for a search request. The query input can be a full or partial address. It can also be a Point of Interest (POI) token, like a name of POI, POI category or name of brand. Furthermore, to improve the relevance of your search results, constrain the query results using a coordinate location and radius, or by defining a bounding box.
66
+
[Fuzzy Search] supports standard single line and free-form searches. We recommend that you use the Azure Maps Search Fuzzy API when you don't know your user input type for a search request. The query input can be a full or partial address. It can also be a Point of Interest (POI) token, like a name of POI, POI category or name of brand. Furthermore, to improve the relevance of your search results, constrain the query results using a coordinate location and radius, or by defining a bounding box.
67
67
68
68
> [!TIP]
69
69
> Most Search queries default to `maxFuzzyLevel=1` to improve performance and reduce unusual results. Adjust fuzziness levels by using the `maxFuzzyLevel` or `minFuzzyLevel` parameters. For more information on `maxFuzzyLevel` and a complete list of all optional parameters, see [Fuzzy Search URI Parameters].
@@ -77,28 +77,28 @@ The example in this section uses `Fuzzy Search` to search the entire world for *
77
77
78
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.
79
79
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.
80
+
1. Select the **GET** HTTP method in the **URL** drop-down list, then enter the following URL:
> The _json_ attribute in the URL path determines the response format. This article uses json for ease of use and readability. To find other supported response formats, see the `format` parameter definition in the [URI Parameter reference] documentation.
88
88
89
-
3. Select **Send** and review the response body.
89
+
1. Select the run button, then review the response body.
90
90
91
-
The ambiguous query string for "pizza" returned 10 [point of interest result] (POI) in both the "pizza" and "restaurant" categories. Each result includes details such as street address, latitude and longitude values, view port, and entry points for the location. The results are now varied for this query, and aren't tied to any reference location.
91
+
The ambiguous query string for "pizza" returned 10 [point of interest] (POI) results in both the "pizza" and "restaurant" categories. Each result includes details such as street address, latitude and longitude values, view port, and entry points for the location. The results are now varied for this query, and aren't tied to any reference location.
92
92
93
-
In the next step, you'll use the `countrySet` parameter to specify only the countries/regions for which your application needs coverage. For a complete list of supported countries/regions, see [Search Coverage].
93
+
In the next step, you'll use the `countrySet` parameter to specify only the countries/regions for which your application needs coverage. For a complete list of supported countries/regions, see [Azure Maps geocoding coverage].
94
94
95
-
4. The default behavior is to search the entire world, potentially returning unnecessary results. Next, search for pizza only in the United States. Add the `countrySet` key to the **Params** section, and set its value to `US`. Setting the `countrySet` key to `US` bounds the results to the United States.
95
+
1. The default behavior is to search the entire world, potentially returning unnecessary results. Next, search for pizza only in the United States. Add the `countrySet` key to the **Params** section, and set its value to `US`. Setting the `countrySet` key to `US` bounds the results to the United States.
96
96
97
97
:::image type="content" source="./media/how-to-search-for-address/search-fuzzy-country.png" alt-text="Search for pizza in the United States":::
98
98
99
99
The results are now bounded by the country code and the query returns pizza restaurants in the United States.
100
100
101
-
5. To get an even more targeted search, you can search over the scope of a lat/lon coordinate pair. The following example uses the lat/lon coordinates of the Seattle Space Needle. Since we only want to return results within a 400-meters radius, we add the `radius` parameter. Also, we add the `limit` parameter to limit the results to the five closest pizza places.
101
+
1. To get an even more targeted search, you can search over the scope of a lat/lon coordinate pair. The following example uses the lat/lon coordinates of the Seattle Space Needle. Since we only want to return results within a 400-meters radius, we add the `radius` parameter. Also, we add the `limit` parameter to limit the results to the five closest pizza places.
102
102
103
103
In the **Params** section, add the following key/value pairs:
104
104
@@ -109,14 +109,14 @@ The example in this section uses `Fuzzy Search` to search the entire world for *
109
109
| radius | 400 |
110
110
| limit | 5 |
111
111
112
-
6. Select **Send**. The response includes results for pizza restaurants near the Seattle Space Needle.
112
+
1. Select run. The response includes results for pizza restaurants near the Seattle Space Needle.
113
113
114
114
## Search for a street address using Reverse Address Search
115
115
116
116
[Get Search Address Reverse] translates coordinates into human readable street addresses. This API is often used for applications that consume GPS feeds and want to discover addresses at specific coordinate points.
117
117
118
118
> [!IMPORTANT]
119
-
> 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].
119
+
> 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].
120
120
121
121
> [!TIP]
122
122
> If you have a set of coordinate locations to reverse geocode, you can use [Post Search Address Reverse Batch] to send a batch of queries in a single request.
@@ -125,32 +125,32 @@ This example demonstrates making reverse searches using a few of the optional pa
125
125
126
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.
127
127
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:
128
+
1. Select the **GET** HTTP method in the **URL** drop-down list, then enter the following URL:
3. Select **Send**, and review the response body. You should see one query result. The response includes key address information about Safeco Field.
134
+
1. Select the run button, and review the response body. You should see one query result. The response includes key address information about Safeco Field.
135
135
136
-
4. Next, add the following key/value pairs to the **Params** section:
136
+
1. Next, add the following key/value pairs to the **Params** section:
137
137
138
-
| Key | Value | Returns
139
-
|-----|------------|------|
140
-
| number | 1 |The response may include the side of the street (Left/Right) and also an offset position for the number.|
138
+
| Key | Value | Returns |
139
+
|-----|-------|---------|
140
+
| number | 1 |The response can include the side of the street (Left/Right) and also an offset position for the number.|
141
141
| returnSpeedLimit | true | Returns the speed limit at the address.|
142
142
| returnRoadUse | true | Returns road use types at the address. For all possible road use types, see [Road Use Types].|
143
-
| returnMatchType | true| Returns the type of match. For all possible values, see [Reverse Address Search Results].
143
+
| returnMatchType | true| Returns the type of match. For all possible values, see [Reverse Address Search Results]. |
1. Select the run button, and review the response body.
148
148
149
-
6. Next, we add the `entityType` key, and set its value to `Municipality`. The `entityType` key overrides the `returnMatchType` key in the previous step. `returnSpeedLimit` and `returnRoadUse` also need removed since you're requesting information about the municipality. For all possible entity types, see [Entity Types].
149
+
1. Next, add the `entityType` key, and set its value to `Municipality`. The `entityType` key overrides the `returnMatchType` key in the previous step. `returnSpeedLimit` and `returnRoadUse` also need removed since you're requesting information about the municipality. For all possible entity types, see [Entity Types].
7. Select **Send**. Compare the results to the results returned in step 5. Because the requested entity type is now `municipality`, the response doesn't include street address information. Also, the returned `geometryId` can be used to request boundary polygon through Azure Maps Get [Search Polygon API].
153
+
1. Select the run button. Compare the results to the results returned in step 5. Because the requested entity type is now `municipality`, the response doesn't include street address information. Also, the returned `geometryId` can be used to request boundary polygon through Azure Maps Get [Search Polygon API].
154
154
155
155
> [!TIP]
156
156
> For more information on these as well as other parameters, see [Reverse Search Parameters].
@@ -161,15 +161,13 @@ This example demonstrates how to search for a cross street based on the coordina
161
161
162
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.
163
163
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:
164
+
1. Select the **GET** HTTP method in the **URL** drop-down list, then enter the following URL:
0 commit comments