你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure Maps 搜索服务的最佳做法

项目
03/10/2023

Azure Maps 搜索服务包括可提供不同功能的 API，可帮助开发人员按名称或类别搜索地址、地点和商家列表，以及其他地理信息。例如，使用 Search Fuzzy，用户可以搜索地址或兴趣点 (POI)。

本文介绍了如何在调用 Azure Maps 搜索服务中的数据时采用最佳做法。将了解如何执行以下操作：

生成查询以返回相关的匹配项
限定搜索结果
了解结果类型之间的差异
读取地址搜索-响应结构

先决条件

可以使用任何 API 开发环境（如 Postman 或 bruno）来运行本文所示的 HTTP 请求示例或生成 REST 调用。

地理编码地址的最佳做法

使用 Azure Maps 搜索服务搜索完整或部分地址时，API 将从搜索查询中读取关键字。然后，它将返回地址的经度和纬度坐标。此过程称为“地理编码”。

在国家/地区中进行地理编码的能力取决于道路数据的可用性和地理编码服务的地理编码精度。有关按国家或地区的 Azure Maps 地理编码功能的详细信息，请参阅地理编码覆盖范围。

限定搜索结果

Azure Maps 搜索 API 有助于你适当地限定搜索结果。你可以限定结果，以便仅向用户显示相关数据。

注意

与本文讨论的参数相比，搜索 API 支持的参数更多。

地理编码的搜索结果

若要将结果地理编码为用户的相关区域，请始终添加尽可能多的位置详细信息。建议通过指定一些输入类型来限定搜索结果：

设置 countrySet 参数。例如，可以将其设置为 US,FR。默认情况下，该 API 会在整个世界中搜索，因此它可能会返回不必要的结果。如果查询没有 countrySet 参数，搜索可能会返回不准确的结果。例如，如果搜索名为 Bellevue 的城市，则会返回来自美国和法国的结果，因为这两个国家/地区都包含名为 Bellevue 的城市。
可使用 btmRight 和 topleft 参数来设置边界框。这些参数将搜索限定为地图上的特定区域。
若要影响结果的相关性区域，请定义 lat 和 lon 坐标参数。请使用 radius 参数设置搜索区域的半径。

模糊搜索参数

如果不知道某个搜索查询的用户输入，我们建议使用 Search Fuzzy。例如，用户的输入可以是地址或兴趣点 (POI) 类型，如“购物中心”。该 API 可将 POI 搜索和地理编码组合成规范的“单行搜索”。

即使查询参数与用户需要的信息不完全匹配，minFuzzyLevel 和 maxFuzzyLevel 参数也有助于返回相关的匹配项。可以将搜索查询设定为默认值 minFuzzyLevel=1 和 maxFuzzyLevel=2，以提高性能并减少不正常的结果。

例如，当 maxFuzzyLevel 参数设置为 2 时，搜索词 restrant 与 restaurant 匹配。可在需要时覆盖默认的模糊级别。
使用 idxSet 参数为一组具体的结果类型设置优先级。要为一组具体的结果设置优先级，可以提交以逗号分隔的索引列表。在列表中，项顺序并不重要。 Azure Maps 支持以下索引：
Addr - 地址范围：从街道的开头和结尾处插入的地址点。这些点表示为地址范围。
Geo - 地理区域：地理行政区域。例如，地理位置可以是国家/地区、省/市/自治区或市县。
PAD - 点地址：包含街道名称和编号的地址。可在索引中找到点地址。例如，Soquel Dr 2501。点地址提供了地址的最高准确性级别。
POI - 兴趣点：地图上的点，值得注意或可能令人感兴趣。 Search Address 不会返回 POI。
Str - 街道：地图上的街道。
XStr - 十字路口或交叉口：两条道路相交的交叉口或位置。

用法示例

idxSet=POI - 仅搜索 POI。
idxSet=PAD,Addr - 仅搜索地址。 PAD 指示点地址，Addr 指示地址范围。

地理实体类型的反向地理编码和筛选

在使用 Search Address Reverse 执行反向地理编码搜索时，该服务可以返回多边形来表示行政区域。例如，你可能想要提取城市的区域多边形。若要将搜索范围缩小到特定地理实体类型，请在请求中包含 entityType 参数。

生成的响应包含地域 ID 和匹配的实体类型。如果提供了多个实体，则终结点将返回可用的最小实体。可使用返回的几何图形 ID 通过 Polygon 搜索服务来获取地理位置的几何图形。

示例请求

https://atlas.microsoft.com/search/address/reverse/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&query=47.6394532,-122.1304551&language=en-US&entityType=Municipality

响应

{
    "summary": {
        "queryTime": 14,
        "numResults": 1
    },
    "addresses": [
        {
            "address": {
                "routeNumbers": [],
                "countryCode": "US",
                "countrySubdivision": "WA",
                "countrySecondarySubdivision": "King",
                "countryTertiarySubdivision": "Seattle East",
                "municipality": "Redmond",
                "country": "United States",
                "countryCodeISO3": "USA",
                "countrySubdivisionName": "Washington"
            },
            "position": "47.639454,-122.130455",
            "dataSources": {
                "geometry": {
                    "id": "00005557-4100-3c00-0000-0000596ae571"
                }
            },
            "entityType": "Municipality"
        }
    ]
}

设置结果语言

使用 language 参数为返回的搜索结果设置语言。如果请求未设置语言，则默认情况下搜索服务将使用该国家或地区的最常用语言。如果指定的语言中没有可用的数据，则将使用默认语言。

有关详细信息，请参阅 Azure Maps 支持的语言。

使用预测模式（自动建议）

若要查找部分查询的更多匹配项，请将 typeahead 参数设置为 true。此查询被解释为部分输入，搜索进入预测模式。如果未将 typeahead 参数设置为 true，则该服务会假定所有相关信息都已传入。

在下面的示例查询中，将针对 Microso 查询地址搜索服务。此处，typeahead 参数设置为 true。响应显示搜索服务将查询解释为部分查询。响应包含自动建议的查询结果。

示例查询

https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&typeahead=true&countrySet=US&lat=47.6370891183&lon=-122.123736172&query=Microsoft

响应

{
    "summary": {
        "query": "microsoft",
        "queryType": "NON_NEAR",
        "queryTime": 18,
        "numResults": 7,
        "offset": 0,
        "totalResults": 7,
        "fuzzyLevel": 1,
        "geoBias": {
            "lat": 47.6370891183,
            "lon": -122.123736172
        }
    },
    "results": [
        {
            "type": "Street",
            "id": "US/STR/p0/9438784",
            "score": 2.594099998474121,
            "dist": 314.0590106663596,
            "address": {
                "streetName": "Microsoft Way",
                "municipalitySubdivision": "Redmond",
                "municipality": "Redmond",
            },
            "position": {
                "lat": 47.63988,
                "lon": -122.12438
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.64223,
                    "lon": -122.1256,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.63748,
                    "lon": -122.12309,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/1756074",
            "score": 2.592679977416992,
            "dist": 876.0272035824189,
            "address": {
                "streetName": "Microsoft Road",
                "municipalitySubdivision": "Redmond",
                "municipality": "Redmond",
                "countrySecondarySubdivision": "King",
                "countryTertiarySubdivision": "Seattle East",
                "countrySubdivision": "WA",
                "countrySubdivisionName": "Washington",
                "postalCode": "98052",
                "countryCode": "US",
                "country": "United States",
                "countryCodeISO3": "USA",
                "freeformAddress": "Microsoft Road, Redmond, WA 98052"
            },
            "position": {
                "lat": 47.64032,
                "lon": -122.1344
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.64253,
                    "lon": -122.13535,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.63816,
                    "lon": -122.13305,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/1470668",
            "score": 2.5290400981903076,
            "dist": 2735.4883918101486,
            "address": {
                "streetName": "Microsoft West Campus Road",
                "municipalitySubdivision": "Redmond",
                "municipality": "Bellevue",
                "countrySecondarySubdivision": "King",
                "countryTertiarySubdivision": "Seattle East",
                "countrySubdivision": "WA",
                "countrySubdivisionName": "Washington",
                "postalCode": "98007",
                "countryCode": "US",
                "country": "United States",
                "countryCodeISO3": "USA",
                "freeformAddress": "Microsoft West Campus Road, Bellevue, WA 98007"
            },
            "position": {
                "lat": 47.65784,
                "lon": -122.14335
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.65785,
                    "lon": -122.14335,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.65784,
                    "lon": -122.14325,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/12812615",
            "score": 2.527509927749634,
            "dist": 2870.9579016916873,
            "address": {
                "streetName": "Microsoft West Campus Road",
                "municipalitySubdivision": "Redmond",
                "municipality": "Redmond",
                "countrySecondarySubdivision": "King",
                "countryTertiarySubdivision": "Seattle East",
                "countrySubdivision": "WA",
                "countrySubdivisionName": "Washington",
                "postalCode": "98052",
                "countryCode": "US",
                "country": "United States",
                "countryCodeISO3": "USA",
                "freeformAddress": "Microsoft West Campus Road, Redmond, WA 98052"
            },
            "position": {
                "lat": 47.66034,
                "lon": -122.1404
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.66039,
                    "lon": -122.14325,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.65778,
                    "lon": -122.13749,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/197588",
            "score": 2.4630401134490967,
            "dist": 878.1404663812472,
            "address": {
                "streetName": "157th Avenue Northeast",
                "municipalitySubdivision": "Redmond",
                "municipality": "Redmond",
                "countrySecondarySubdivision": "King",
                "countryTertiarySubdivision": "Seattle East",
                "countrySubdivision": "WA",
                "countrySubdivisionName": "Washington",
                "postalCode": "98052",
                "extendedPostalCode": "980525344, 980525398, 980525399",
                "countryCode": "US",
                "country": "United States",
                "countryCodeISO3": "USA",
                "freeformAddress": "157th Avenue Northeast, Redmond, WA 98052"
            },
            "position": {
                "lat": 47.64351,
                "lon": -122.13056
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.64473,
                    "lon": -122.13058,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.6425,
                    "lon": -122.13016,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/3033991",
            "score": 2.0754499435424805,
            "dist": 3655467.8844475765,
            "address": {
                "streetName": "Microsoft Way",
                "municipalitySubdivision": "Yorkmount, Charlotte",
            },
            "position": {
                "lat": 35.14267,
                "lon": -80.91824
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 35.14287,
                    "lon": -80.91839,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 35.14267,
                    "lon": -80.91814,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/8395877",
            "score": 2.0754499435424805,
            "dist": 3655437.0037482483,
            "address": {
                "streetName": "Microsoft Way",
                "municipalitySubdivision": "Charlotte",
                "municipality": "Charlotte",
                "countrySecondarySubdivision": "Mecklenburg",
                "countryTertiarySubdivision": "Township 1 Charlotte",
                "countrySubdivision": "NC",
                "countrySubdivisionName": "North Carolina",
                "postalCode": "28273",
                "extendedPostalCode": "282738105, 282738106, 282738108, 2827382, 282738200",
                "countryCode": "US",
                "country": "United States",
                "countryCodeISO3": "USA",
                "freeformAddress": "Microsoft Way, Charlotte, NC 28273"
            },
            "position": {
                "lat": 35.14134,
                "lon": -80.9198
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 35.14274,
                    "lon": -80.92159,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 35.14002,
                    "lon": -80.91824,
                    "valid": true
                }
            }
        }
    ]
}

对 URI 进行编码以处理特殊字符

若要查找十字路口地址，必须对 URI 进行编码，使其能够处理地址中的特殊字符。考虑以下地址示例：1st Avenue & Union Street, Seattle。在此示例中，发送请求之前，请对与符号 (&) 进行编码。

建议在 URI 中对字符数据进行编码。在 URI 中，使用百分号 (%) 和两个字符的十六进制值（与字符的 UTF-8 代码相对应）对所有字符进行编码。

用法示例

从以下地址开始：

query=1st Avenue & E 111th St, New York

对地址进行编码：

query=1st%20Avenue%20%26%20E%20111th%20St%2C%20New%20York

可使用以下方法。

JavaScript 或 TypeScript：

encodeURIComponent(query)

C# 或 Visual Basic：

Uri.EscapeDataString(query)

Java:

URLEncoder.encode(query, "UTF-8")

Python:

import urllib.parse 
urllib.parse.quote(query)

C++：

#include <curl/curl.h>
curl_easy_escape(query)

PHP：

urlencode(query)

Ruby：

CGI::escape(query)

Swift：

query.stringByAddingPercentEncodingWithAllowedCharacters(.URLHostAllowedCharacterSet())

GO：

import ("net/url") 
url.QueryEscape(query)

有关 POI 搜索的最佳做法

在 POI 搜索中，可以按名称请求 POI 结果。例如，可按名称搜索企业。

强烈建议使用 countrySet 参数指定应用程序需要覆盖的国家/地区。默认行为是在整个世界中搜索。此搜索范围可能会返回不必要的结果，并且搜索可能需要较长时间。

品牌搜索

为了改善结果与响应中信息的相关性，POI 搜索响应中包含品牌信息。可使用此信息进一步分析响应。

在请求中，可提交以逗号分隔的品牌名称列表。使用此列表，通过设置 brandSet 参数将结果限定为特定品牌。在列表中，项顺序并不重要。如果提供多个品牌列表，则返回的结果必须属于至少一个列表。

若要探索品牌搜索，请创建 POI 类别搜索请求。在下面的示例中，我们将寻找位于华盛顿州雷蒙德的 Microsoft 校园附近的加油站。响应显示返回的每个 POI 的品牌信息。

示例查询

https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&query=gas%20station&limit=3&lat=47.6413362&lon=-122.1327968

响应

{
    "summary": {
        "query": "gas station",
        "queryType": "NON_NEAR",
        "queryTime": 276,
        "numResults": 3,
        "offset": 0,
        "totalResults": 762680,
        "fuzzyLevel": 1,
        "geoBias": {
            "lat": 47.6413362,
            "lon": -122.1327968
        }
    },
    "results": [
        {
            "type": "POI",
            "id": "US/POI/p0/8831765",
            "score": 5.6631999015808105,
            "dist": 1037.0280221303253,
            "info": "search:ta:840531000004190-US",
            "poi": {
                "name": "Chevron",
                "phone": "+(1)-(425)-6532200",
                "brands": [
                    {
                        "name": "Chevron"
                    }
                ],
                "categorySet": [
                    {
                        "id": 7311
                    }
                ],
                "url": "www.chevron.com",
                "categories": [
                    "petrol station"
                ],
                "classifications": [
                    {
                        "code": "PETROL_STATION",
                        "names": [
                            {
                                "nameLocale": "en-US",
                                "name": "petrol station"
                            }
                        ]
                    }
                ]
            },
            "address": {
                "streetNumber": "2444",
                "streetName": "Bel Red Rd",
                "municipalitySubdivision": "Northeast Bellevue, Bellevue",
            },
            "position": {
                "lat": 47.63201,
                "lon": -122.13281
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.63291,
                    "lon": -122.13414,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.63111,
                    "lon": -122.13148,
                    "valid": true
                }
            },
            "entryPoints": [
                {
                    "type": "main",
                    "position": {
                        "lat": 47.63222,
                        "lon": -122.13312,
                        "valid": true
                    }
                }
            ]
        },
        {
            "type": "POI",
            "id": "US/POI/p0/8831752",
            "score": 5.662710189819336,
            "dist": 1330.1278248163273,
            "info": "search:ta:840539001100326-US",
            "poi": {
                "name": "76",
                "phone": "+(1)-(425)-7472126",
                "brands": [
                    {
                        "name": "76"
                    }
                ],
                "categorySet": [
                    {
                        "id": 7311
                    }
                ],
                "url": "www.76.com",
                "categories": [
                    "petrol station"
                ],
                "classifications": [
                    {
                        "code": "PETROL_STATION",
                        "names": [
                            {
                                "nameLocale": "en-US",
                                "name": "petrol station"
                            }
                        ]
                    }
                ]
            },
            "address": {
                "streetNumber": "2421",
                "streetName": "148Th Ave Ne",
                "municipalitySubdivision": "Redmond, Bridle Trails, Bellevue",
                "municipality": "Redmond, Bellevue",
                "countrySecondarySubdivision": "King",
                "countryTertiarySubdivision": "Seattle East",
                "countrySubdivision": "WA",
                "countrySubdivisionName": "Washington",
                "postalCode": "98007",
                "countryCode": "US",
                "country": "United States",
                "countryCodeISO3": "USA",
                "freeformAddress": "2421 148Th Ave Ne, Bellevue, WA 98007",
                "localName": "Bellevue"
            },
            "position": {
                "lat": 47.63187,
                "lon": -122.14365
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.63277,
                    "lon": -122.14498,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.63097,
                    "lon": -122.14232,
                    "valid": true
                }
            },
            "entryPoints": [
                {
                    "type": "minor",
                    "position": {
                        "lat": 47.63187,
                        "lon": -122.14374,
                        "valid": true
                    }
                },
                {
                    "type": "main",
                    "position": {
                        "lat": 47.63186,
                        "lon": -122.14313,
                        "valid": true
                    }
                }
            ]
        },
        {
            "type": "POI",
            "id": "US/POI/p0/8831764",
            "score": 5.662449836730957,
            "dist": 1458.645407416307,
            "info": "search:ta:840539000488527-US",
            "poi": {
                "name": "BROWN BEAR CAR WASH",
                "phone": "+(1)-(425)-6442868",
                "brands": [
                    {
                        "name": "Texaco"
                    }
                ],
                "categorySet": [
                    {
                        "id": 7311
                    }
                ],
                "url": "www.texaco.com/",
                "categories": [
                    "petrol station"
                ],
                "classifications": [
                    {
                        "code": "PETROL_STATION",
                        "names": [
                            {
                                "nameLocale": "en-US",
                                "name": "petrol station"
                            }
                        ]
                    }
                ]
            },
            "address": {
                "streetNumber": "15248",
                "streetName": "Bel Red Rd",
                "municipalitySubdivision": "Redmond",
            },
            "position": {
                "lat": 47.62843,
                "lon": -122.13628
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.62933,
                    "lon": -122.13761,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.62753,
                    "lon": -122.13495,
                    "valid": true
                }
            },
            "entryPoints": [
                {
                    "type": "main",
                    "position": {
                        "lat": 47.62827,
                        "lon": -122.13628,
                        "valid": true
                    }
                }
            ]
        }
    ]
}

机场搜索

通过使用 POI 搜索 API，你可以使用其官方代码查找机场。例如，可以使用 SEA 查找西雅图-塔科马国际机场：

https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&query=SEA

附近搜索

若要检索特定位置周边的 POI 结果，可以尝试使用 Search Nearby。终结点仅返回 POI 结果。它不接受搜索查询参数。

建议设置半径以限定结果。

了解响应

让我们通过向 Azure Maps 搜索服务发出地址搜索请求来查找西雅图的一个地址。在下面的请求 URL 中，我们将 countrySet 参数设置为 US 以搜索美国地址。

示例查询

https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1&query=400%20Broad%20Street%2C%20Seattle%2C%20WA&countrySet=US

支持的结果类型

点地址：地图上的点，包含特定地址并附有街道名称和编号。点地址提供了地址的最高准确性级别。
地址范围：从街道的开头和结尾处插入的地址点范围。
Geography：地图上的区域，表示地理行政区域，例如国家/地区、州、省/市/自治区或市/县。
POI：地图上的点，值得注意或可能令人感兴趣。
街道：地图上的街道。地址解析为包含地址的街道的纬度和经度坐标。门牌号码可能不会处理。
十字路口：交叉路口。十字路口表示两条道路相交的交叉口。

响应

让我们看一下响应结构。在下面的响应中，结果对象的类型不同。如果仔细看一看，你将看到三种类型的结果对象：

点地址
街道
十字路口

请注意，地址搜索不会返回 POI。

每个响应对象的 Score 参数指示匹配的分数如何与同一响应中其他对象的分数相关。有关响应对象参数的详细信息，请参阅获取搜索地址。

{
    "summary": {
        "query": "400 broad street seattle wa",
        "queryType": "NON_NEAR",
        "queryTime": 146,
        "numResults": 6,
        "offset": 0,
        "totalResults": 7,
        "fuzzyLevel": 1
    },
    "results": [
        {
            "type": "Point Address",
            "id": "US/PAD/p0/28725082",
            "score": 9.893799781799316,
            "address": {
                "streetNumber": "400",
                "streetName": "Broad Street",
            },
            "position": {
                "lat": 47.62039,
                "lon": -122.34928
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.62129,
                    "lon": -122.35061,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.61949,
                    "lon": -122.34795,
                    "valid": true
                }
            },
            "entryPoints": [
                {
                    "type": "main",
                    "position": {
                        "lat": 47.61982,
                        "lon": -122.34886,
                        "valid": true
                    }
                }
            ]
        },
        {
            "type": "Street",
            "id": "US/STR/p0/6700384",
            "score": 8.129190444946289,
            "address": {
                "streetName": "Broad Street",
            },
            "position": {
                "lat": 47.61724,
                "lon": -122.35207
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.61825,
                    "lon": -122.35336,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.61626,
                    "lon": -122.35078,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/9701953",
            "score": 8.129190444946289,
            "address": {
                "streetName": "Broad Street",
            },
            "position": {
                "lat": 47.61965,
                "lon": -122.349
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.62066,
                    "lon": -122.35041,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.61857,
                    "lon": -122.34761,
                    "valid": true
                }
            }
        },
        {
            "type": "Street",
            "id": "US/STR/p0/11721297",
            "score": 8.129190444946289,
            "address": {
                "streetName": "Broad Street",
                "municipalitySubdivision": "Seattle, Downtown Seattle, Denny Regrade, Belltown",
                "municipality": "Seattle",
                "countrySecondarySubdivision": "King",
                "countryTertiarySubdivision": "Seattle",
                "countrySubdivision": "WA",
                "countrySubdivisionName": "Washington",
                "postalCode": "98121",
                "extendedPostalCode": "981211237",
                "countryCode": "US",
                "country": "United States",
                "countryCodeISO3": "USA",
                "freeformAddress": "Broad Street, Seattle, WA 98121"
            },
            "position": {
                "lat": 47.61825,
                "lon": -122.35078
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.61857,
                    "lon": -122.35078,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.61825,
                    "lon": -122.35041,
                    "valid": true
                }
            }
        },
        {
            "type": "Cross Street",
            "id": "US/XSTR/p1/232144",
            "score": 6.754479885101318,
            "address": {
                "streetName": "Broad Street & Valley Street",
                "municipalitySubdivision": "South Lake Union, Seattle",
            },
            "position": {
                "lat": 47.62545,
                "lon": -122.33974
            },
            "viewport": {
                "topLeftPoint": {
                    "lat": 47.62635,
                    "lon": -122.34107,
                    "valid": true
                },
                "btmRightPoint": {
                    "lat": 47.62455,
                    "lon": -122.33841,
                    "valid": true
                }
            }
        }
    ]
}

Geometry

Geometry 响应类型可能包括在 geometry 和 id 下的 dataSources 对象中返回的几何图形 ID。例如，可使用 Polygon 搜索服务以 GeoJSON 格式请求几何数据。使用此格式可以获取一组实体的城市或机场分布。然后，可以使用此边界数据设置地理围栏或在几何图形内搜索 POI。

Search Address 或 Search Fuzzy 的响应可以包括在 dataSources 对象的 geometry 和 id 下返回的几何图形 ID：

"dataSources": { 
        "geometry": { 
            "id": "00005557-4100-3c00-0000-000059690938" // The geometry ID is returned in the dataSources object under "geometry" and "id".
        }
}

后续步骤

有关详细信息，请参阅：

如何生成 Azure Maps 搜索服务请求

搜索服务 API 文档

通过

Azure Maps 搜索服务的最佳做法

先决条件

地理编码地址的最佳做法

限定搜索结果

地理编码的搜索结果

模糊搜索参数

用法示例

地理实体类型的反向地理编码和筛选

示例请求

响应

设置结果语言

使用预测模式（自动建议）

示例查询

响应

对 URI 进行编码以处理特殊字符

用法示例

有关 POI 搜索的最佳做法

品牌搜索

示例查询

响应

机场搜索

附近搜索

了解响应

示例查询

支持的结果类型

响应

Geometry

后续步骤

反馈

其他资源