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-use-best-practices-for-search.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ titleSuffix: Microsoft Azure Maps
4
4
description: Learn how to apply the best practices when using the Search service from Microsoft Azure Maps.
5
5
author: farazgis
6
6
ms.author: fsiddiqui
7
-
ms.date: 10/28/2021
7
+
ms.date: 3/24/2026
8
8
ms.topic: best-practice
9
9
ms.service: azure-maps
10
10
ms.subservice: search
@@ -1098,16 +1098,15 @@ When geocoding large address datasets, expect that some records won't return res
1098
1098
1099
1099
Common causes include:
1100
1100
1101
-
* Misspellings or inconsistent formatting
1101
+
* Misspellings or inconsistent address formatting
1102
1102
* Incomplete addresses
1103
1103
* Interior details (for example, apartment, suite, or floor numbers) that aren't part of a deliverable address
1104
1104
1105
1105
Treat geocoding as a data enrichment process rather than a strict validation step:
1106
1106
1107
1107
* Submit addresses for geocoding.
1108
-
* Identify records that aren't resolved.
1109
-
* Flag unresolved addresses for review or normalization.
1110
-
* Retry geocoding only after cleaning the source data.
1108
+
* Accept high‑confidence matches and flag unresolved or low‑confidence results.
1109
+
* Reprocess flagged records only after cleaning or normalizing the source data.
1111
1110
1112
1111
Avoid attempting to force matches for low‑quality input, as this can introduce incorrect or misleading location data into downstream systems.
1113
1112
@@ -1117,14 +1116,15 @@ A geocoding request may return an HTTP 200 (OK) response with no results.
1117
1116
1118
1117
This indicates that the request was processed successfully, but no matching address or place was found. It doesn't represent a failure of the service.
1119
1118
1120
-
Applications should handle empty results explicitly and avoid treating them as errors. In many scenarios, returning no result is preferable to returning a low‑confidence or incorrect match.
1119
+
Applications should handle empty results explicitly and avoid treating them as errors. In many scenarios, returning no result is preferable to returning a low‑confidence or incorrect match. Search inputs should be reviewed and edited before retrying.
1121
1120
1122
1121
> [!NOTE]
1123
1122
> Azure Maps request limits, quotas, and throttling behavior are configured at the Azure subscription level.
1124
1123
> For information on pricing, usage limits, and monitoring, see:
1125
1124
>
1126
1125
> *[Azure Maps pricing]
1127
1126
> *[Understanding Azure Maps transactions]
1127
+
> *[Use cost alerts to monitor usage and spending]
1128
1128
1129
1129
## Best practices for autocomplete
1130
1130
@@ -1276,3 +1276,4 @@ GET https://atlas.microsoft.com/polygon
0 commit comments