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/migrate-search-v1-api.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ ms.subservice: search
12
12
13
13
# Migrate Azure Maps Search 1.0 APIs
14
14
15
-
[Search][Search v1] API version 1.0 is superseded by the [Search][Search v2026-01-01] 2026‑01‑01 API. The newer version introduces task‑specific endpoints, clearer intent, and improved scalability. This article explains how to migrate existing Search v1 integrations.
15
+
[Search][Search v2026-01-01] API version 2026‑01‑01 supersedes [Search][Search v1]API version 1.0. The newer version introduces task‑specific endpoints, clearer intent, and improved scalability. This article explains how to migrate existing Search v1 integrations.
16
16
17
17
> [!IMPORTANT]
18
18
> Azure Maps [Search API version 1.0][Search v1] has been superseded by [Search API version 2026‑01‑01][Search v2026-01-01]. While Search v1 continues to function, new development should use the latest Search API to access task‑specific endpoints, improved performance, and long‑term support. To avoid future service disruptions, migrate existing Search v1 integrations to Search 2026‑01‑01.
@@ -22,7 +22,7 @@ ms.subservice: search
22
22
| Purpose | Search v1 API | Search 2026‑01‑01 API |
@@ -70,9 +70,9 @@ When migrating, review how your application interprets search responses:
70
70
- A successful request may return **no results** when no suitable match is found. For more information, see [Understand empty geocoding results].
71
71
- Low‑confidence or loosely related matches are less likely to be returned automatically.
72
72
- Applications should evaluate **confidence values**, **match codes**, and **entity types** when determining whether a result is acceptable. For more information, see [Improve result quality for query-based geocoding].
73
-
- If a requested entity is not found, the service may return a higher‑level entity in the address hierarchy (for example, a region instead of a city). For more information on evaluating result quality and validating that returned entity types match the intended search scenario, see [Best practices for forward geocoding] in _Best practices for Azure Maps Search service_.
73
+
- If a requested entity isn't found, the service may return a higher‑level entity in the address hierarchy (for example, a region instead of a city). For more information on evaluating result quality and validating that returned entity types match the intended search scenario, see [Best practices for forward geocoding] in _Best practices for Azure Maps Search service_.
74
74
75
-
Do not assume that every successful request will return a usable result. Explicit result evaluation is required to maintain data quality.
75
+
Don't assume that every successful request returns a usable result. Explicit result evaluation is required to maintain data quality.
0 commit comments