다음을 통해 공유


SearchURL class

SearchURL은 Azure Maps 검색 작업의 URL을 나타냅니다.

Extends

생성자

SearchURL(Pipeline, string)

SearchURL의 instance 만듭니다.

상속된 속성

mapsUrl

기본 URL 문자열 값입니다.

메서드

searchAddress(Aborter, string, SearchAddressOptions)

주소 지오코딩 대부분의 경우 기존 지오코딩에만 관심이 있는 경우 instance 전체 검색 서비스가 너무 많을 수 있습니다. Search 주소 조회에만 액세스할 수도 있습니다. 지오코딩은 해당 주소 또는 부분 주소로 지오코드 엔드포인트를 눌러 수행됩니다. 지오코딩 검색 인덱스가 거리 수준 데이터 위의 모든 항목에 대해 쿼리됩니다. POI가 반환되지 않습니다. 지오코더는 오타 및 불완전한 주소에 대해 매우 관대합니다. 또한 정확한 거리 주소 또는 거리 또는 교차로뿐만 아니라 도심, 카운티, 주 등과 같은 높은 수준의 지역에서 모든 것을 처리합니다. Search 주소 가져오기 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddress

searchAddressReverse(Aborter, GeoJSON.Position, SearchAddressReverseOptions)

주소로 지오코드 역방향 좌표(예: -122.3862, 37.786505)를 사람이 이해할 수 있는 거리 주소로 변환해야 하는 경우가 있을 수 있습니다. 대부분의 경우 디바이스 또는 자산에서 GPS 피드를 수신하고 좌표가 있는 주소를 알고자 하는 애플리케이션을 추적하는 데 필요합니다. 이 엔드포인트는 지정된 좌표에 대한 주소 정보를 반환합니다. get Search Address Reverse API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddressreverse

searchAddressReverseCrossStreet(Aborter, GeoJSON.Position, SearchAddressReverseCrossStreetOptions)

지오코드를 크로스 스트리트로 역방향 좌표(예: -122.3862, 37.786505)를 사람이 이해할 수 있는 교차로로 변환해야 하는 경우가 있을 수 있습니다. 대부분의 경우 디바이스 또는 자산에서 GPS 피드를 수신하고 좌표가 있는 주소를 알고자 하는 애플리케이션을 추적하는 데 필요합니다. 이 엔드포인트는 지정된 좌표에 대한 교차 거리 정보를 반환합니다. Get Search Address Reverse Cross Street API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddressreversecrossstreet

searchAddressStructured(Aborter, string, SearchAddressStructuredOptions)

구조적 주소 지오코딩 구조화된 주소 조회를 위해 Azure Address Geocoding에만 액세스할 수 있습니다. 지오코딩 검색 인덱스가 거리 수준 데이터 위의 모든 항목에 대해 쿼리됩니다. POI가 반환되지 않습니다. 지오코더는 오타 및 불완전한 주소에 대해 매우 관대합니다. 또한 정확한 거리 주소 또는 거리 또는 교차로뿐만 아니라 도심, 카운티, 주 등과 같은 높은 수준의 지역에서 모든 것을 처리합니다. get Search Address Structured API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddressstructured

searchAlongRoute(Aborter, string, number, SearchAlongRouteRequestBody, SearchAlongRouteOptions)

경로에 따라 Search 엔드포인트를 사용하면 지정된 경로를 따라 POI에 대한 유사 항목 검색을 수행할 수 있습니다. 이 검색은 제한 측정값을 지정하여 maxDetourTime 제한됩니다. 경로 지점을 보내려면 형식으로 GeoJSON LineString 표시되는 개체를 route 포함하는 를 사용하고 body 헤더는 Content-Type 로 설정application/json됩니다. 의 route 각 경로 지점은 형식으로 GeoJSON Position 표시됩니다. 즉 , 경도 값 뒤에 위도 값이 잇고 고도 값이 무시되는 배열입니다. 에는 route 2개 이상의 경로 지점이 포함되어야 합니다. 원래 경로가 변경될 수 있으며, 그 중 일부는 건너뛸 수 있습니다. 찾은 지점을 통과하는 경로가 원래 경로보다 빠르면 응답의 detourTime 값이 음수입니다. 경로 API를 따라 Post Search 사용합니다.https://docs.microsoft.com/rest/api/maps/search/postsearchalongroute

searchFuzzy(Aborter, string | GeoJSON.Position, SearchFuzzyOptions)

무료 양식 Search 기본 기본 API는 주소 또는 POI 토큰의 조합을 처리하는 가장 유사하게 입력을 처리하는 자유 형식 Search. 이 검색 API는 정식 '단일 줄 검색'입니다. 무료 양식 Search API는 POI 검색과 지오코딩의 원활한 조합입니다. 또한 API는 컨텍스트 위치(lat./lon. pair)로 가중치를 부여하거나 좌표와 반경으로 완전히 제한되거나 지리적 바이어스 앵커 포인트 없이 더 일반적으로 실행할 수 있습니다. 기본 동작은 전 세계를 검색하고 잠재적으로 불필요한 결과를 반환하기 때문에 'countrySet' 매개 변수를 사용하여 애플리케이션에 적용이 필요한 국가만 지정하는 것이 좋습니다. 예: countrySet=US,FR. 지원되는 모든 국가의 전체 목록은 [Search 적용 범위](https://docs.microsoft.com/azure/location-based-services/geocoding-coverage)를 참조하세요. 대부분의 Search 쿼리는 성능을 얻고 비정상적인 결과를 줄이기 위해 기본적으로 maxFuzzyLevel=2입니다. 이 새 기본값은 쿼리 매개 변수 maxFuzzyLevel=3 또는 4를 전달하여 요청당 필요에 따라 재정의할 수 있습니다. Get Search 유사 항목 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchfuzzy

searchInsideGeometry(Aborter, string, SearchInsideGeometryRequestBody, SearchInsideGeometryOptions)

Search 기하 도형 엔드포인트를 사용하면 단일 기하 도형 또는 여러 기하 도형 내에서 자유 형식 검색을 수행할 수 있습니다. 기하 도형/기하 도형에 속하는 검색 결과가 반환됩니다. 검색할 지리적 기능은 GeoJSON FeatureCollection, The geometry 형식 중 GeoJSON 하나를 사용하여 나타내는 Polygon 및/또는 원 기하 도형으로 GeoJSON FeatureCollection 모델링할 수 있습니다. 기하 도형에 다각형과 원을 모두 포함하는 경우 이 옵션을 사용하는 것이 좋습니다. 에는 FeatureCollection 최대 50 GeoJSON Feature 개의 개체가 포함될 수 있습니다. 각 Feature 개체는 다음 조건을 가진 Polygon 또는 Circle을 나타내야 합니다. Feature Polygon 기하 도형의 개체는 최대 50개의 좌표를 가질 수 있으며 속성은 비어 있어야 합니다. Feature Circle 기하 도형의 개체는 형식을 사용하여 GeoJSON Point 표현되는 가운데와 값이 'Circle'이어야 하는 subType 속성과 함께 개체의 속성에 지정해야 하는 반경 값(미터)으로 구성됩니다. 샘플 FeatureCollection 표현은 아래 예제 섹션을 참조하세요. GeoJSON GeometryCollection, 개체 geometryGeoJSON GeometryCollection 나타낼 수 있습니다. 기하 도형에 다각형 목록만 포함된 경우 권장되는 옵션입니다. 에는 GeometryCollection 최대 50 GeoJSON Polygon 개의 개체가 포함될 수 있습니다. 각 Polygon 개체에는 최대 50개의 좌표가 있을 수 있습니다. 샘플 GeometryCollection 표현은 아래 예제 섹션을 참조하세요. GeoJSON 다각형, 개체 geometryGeoJSON Polygon 나타낼 수 있습니다. 기하 도형에 단일 다각형이 포함된 경우 권장되는 옵션입니다. 개체에는 Polygon 최대 50개의 좌표가 있을 수 있습니다. Post Search Inside Geometry API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/postsearchinsidegeometry

searchNearby(Aborter, GeoJSON.Position, SearchNearbyOptions)

주변 Search 특정 위치 주변에서 POI 결과만 검색하는 사용 사례가 있는 경우 가까운 검색 방법이 올바른 선택일 수 있습니다. 이 엔드포인트는 POI 결과만 반환하고 검색 쿼리 매개 변수를 사용하지 않습니다. 근거리 Search 가져오기 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchnearby

searchPOI(Aborter, string, SearchPOIOptions)

이름으로 POI 가져오기 검색 사용 사례에 POI 결과만 필요한 경우 검색에 POI 엔드포인트를 사용할 수 있습니다. 이 엔드포인트는 POI 결과만 반환합니다. GET Search POI API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchpoi

searchPOICategory(Aborter, string, SearchPOICategoryOptions)

범주별 POI 가져오기 검색 사용 사례에 범주별로 필터링된 POI 결과만 필요한 경우 범주 엔드포인트를 사용할 수 있습니다. 이 엔드포인트는 지정된 대로 분류된 POI 결과만 반환합니다. 사용 가능한 범주 목록은 여기에서 찾을 수 있습니다. Search POI 범주 가져오기 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchpoicategory

searchPolygon(Aborter, string[])

Search Polygon API를 사용하면 이전에 GeoJSON 형식의 온라인 Search 요청에서 검색된 엔터티 집합에 대한 도시 또는 국가 개요와 같은 기하 도형 데이터를 요청할 수 있습니다. geometry ID는 Search Address 또는 Search 유사 항목 호출에서 "geometry" 및 "id"의 dataSources 개체에 반환됩니다. 온라인 Search 엔드포인트에서 검색된 기하 도형 ID는 수명이 제한됩니다. 이러한 식별자의 안정성이 장기간 보장되지 않으므로 클라이언트는 이후 조회를 위해 영구 스토리지에 기하 도형 ID를 저장해서는 안 됩니다. Id를 제공한 Online Search 메서드에 대한 요청 후 몇 분 이내에 Polygon 메서드에 대한 요청이 이루어질 것으로 예상됩니다. 이 서비스는 최대 20개의 식별자를 일괄 처리 요청할 수 있습니다.

Get Search Polygon API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchpolygon

상속된 메서드

newPipeline(Credential, INewPipelineOptions)

자격 증명이 제공된 새 Pipeline 개체를 만드는 데 사용되는 정적 메서드입니다.

생성자 세부 정보

SearchURL(Pipeline, string)

SearchURL의 instance 만듭니다.

new SearchURL(pipeline: Pipeline, mapsUrl?: string)

매개 변수

pipeline
Pipeline

MapsURL.newPipeline()을 호출하여 기본 파이프라인을 만들거나 사용자 지정된 파이프라인을 제공합니다.

mapsUrl

string

Azure Maps 서비스를 가리키는 URL 문자열은 기본값입니다"https://atlas.microsoft.com". 프로토콜이 지정되지 않은 경우(예: "atlas.microsoft.com") 가 https 가정됩니다.

상속된 속성 세부 정보

mapsUrl

기본 URL 문자열 값입니다.

mapsUrl: string

속성 값

string

MapsURL.mapsUrl에서 상속됨

메서드 세부 정보

searchAddress(Aborter, string, SearchAddressOptions)

주소 지오코딩 대부분의 경우 기존 지오코딩에만 관심이 있는 경우 instance 전체 검색 서비스가 너무 많을 수 있습니다. Search 주소 조회에만 액세스할 수도 있습니다. 지오코딩은 해당 주소 또는 부분 주소로 지오코드 엔드포인트를 눌러 수행됩니다. 지오코딩 검색 인덱스가 거리 수준 데이터 위의 모든 항목에 대해 쿼리됩니다. POI가 반환되지 않습니다. 지오코더는 오타 및 불완전한 주소에 대해 매우 관대합니다. 또한 정확한 거리 주소 또는 거리 또는 교차로뿐만 아니라 도심, 카운티, 주 등과 같은 높은 수준의 지역에서 모든 것을 처리합니다. Search 주소 가져오기 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddress

function searchAddress(aborter: Aborter, query: string, options?: SearchAddressOptions): Promise<SearchAddressResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout(), Aborter의 goto 문서를 사용하여 새 중단자 instance 만듭니다.

query

string

검색할 주소입니다(예: "1 Microsoft way, Redmond, WA").

반환

searchAddressReverse(Aborter, GeoJSON.Position, SearchAddressReverseOptions)

주소로 지오코드 역방향 좌표(예: -122.3862, 37.786505)를 사람이 이해할 수 있는 거리 주소로 변환해야 하는 경우가 있을 수 있습니다. 대부분의 경우 디바이스 또는 자산에서 GPS 피드를 수신하고 좌표가 있는 주소를 알고자 하는 애플리케이션을 추적하는 데 필요합니다. 이 엔드포인트는 지정된 좌표에 대한 주소 정보를 반환합니다. get Search Address Reverse API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddressreverse

function searchAddressReverse(aborter: Aborter, position: GeoJSON.Position, options?: SearchAddressReverseOptions): Promise<SearchAddressReverseResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout(), Aborter의 goto 문서를 사용하여 새 중단자 instance 만듭니다.

position
GeoJSON.Position

역방향 검색을 위한 위치, 예를 들어 의 [longitude, latitude] 좌표 배열입니다. [-122.125679, 47.641268]

반환

searchAddressReverseCrossStreet(Aborter, GeoJSON.Position, SearchAddressReverseCrossStreetOptions)

지오코드를 크로스 스트리트로 역방향 좌표(예: -122.3862, 37.786505)를 사람이 이해할 수 있는 교차로로 변환해야 하는 경우가 있을 수 있습니다. 대부분의 경우 디바이스 또는 자산에서 GPS 피드를 수신하고 좌표가 있는 주소를 알고자 하는 애플리케이션을 추적하는 데 필요합니다. 이 엔드포인트는 지정된 좌표에 대한 교차 거리 정보를 반환합니다. Get Search Address Reverse Cross Street API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddressreversecrossstreet

function searchAddressReverseCrossStreet(aborter: Aborter, position: GeoJSON.Position, options?: SearchAddressReverseCrossStreetOptions): Promise<SearchAddressReverseCrossStreetResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout(), Aborter의 goto 문서를 사용하여 새 중단자 instance 만듭니다.

position
GeoJSON.Position

역방향 검색을 위한 위치, 예를 들어 의 [longitude, latitude] 좌표 배열입니다. [-122.125679, 47.641268]

반환

searchAddressStructured(Aborter, string, SearchAddressStructuredOptions)

구조적 주소 지오코딩 구조화된 주소 조회를 위해 Azure Address Geocoding에만 액세스할 수 있습니다. 지오코딩 검색 인덱스가 거리 수준 데이터 위의 모든 항목에 대해 쿼리됩니다. POI가 반환되지 않습니다. 지오코더는 오타 및 불완전한 주소에 대해 매우 관대합니다. 또한 정확한 거리 주소 또는 거리 또는 교차로뿐만 아니라 도심, 카운티, 주 등과 같은 높은 수준의 지역에서 모든 것을 처리합니다. get Search Address Structured API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchaddressstructured

function searchAddressStructured(aborter: Aborter, countryCode: string, options?: SearchAddressStructuredOptions): Promise<SearchAddressStructuredResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout(), Aborter의 goto 문서를 사용하여 새 중단자 instance 만듭니다.

countryCode

string

주소의 2개 또는 3개 문자 ISO3166-1 개 국가 코드 부분입니다. 예: 미국

반환

searchAlongRoute(Aborter, string, number, SearchAlongRouteRequestBody, SearchAlongRouteOptions)

경로에 따라 Search 엔드포인트를 사용하면 지정된 경로를 따라 POI에 대한 유사 항목 검색을 수행할 수 있습니다. 이 검색은 제한 측정값을 지정하여 maxDetourTime 제한됩니다. 경로 지점을 보내려면 형식으로 GeoJSON LineString 표시되는 개체를 route 포함하는 를 사용하고 body 헤더는 Content-Type 로 설정application/json됩니다. 의 route 각 경로 지점은 형식으로 GeoJSON Position 표시됩니다. 즉 , 경도 값 뒤에 위도 값이 잇고 고도 값이 무시되는 배열입니다. 에는 route 2개 이상의 경로 지점이 포함되어야 합니다. 원래 경로가 변경될 수 있으며, 그 중 일부는 건너뛸 수 있습니다. 찾은 지점을 통과하는 경로가 원래 경로보다 빠르면 응답의 detourTime 값이 음수입니다. 경로 API를 따라 Post Search 사용합니다.https://docs.microsoft.com/rest/api/maps/search/postsearchalongroute

function searchAlongRoute(aborter: Aborter, query: string, maxDetourTime: number, body: SearchAlongRouteRequestBody, options?: SearchAlongRouteOptions): Promise<SearchAlongRouteResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.

query

string

해당하는 쿼리 문자열(예: "seattle", "pizza")입니다.

maxDetourTime

number

관심 지점의 최대 우회 시간(초)입니다. 최대값은 3600초입니다.

body
SearchAlongRouteRequestBody

이는 검색할 경로를 나타내며 유효한 GeoJSON LineString 형식이어야 합니다. 자세한 내용은 RFC 7946 을 참조하세요.

반환

searchFuzzy(Aborter, string | GeoJSON.Position, SearchFuzzyOptions)

무료 양식 Search 기본 기본 API는 주소 또는 POI 토큰의 조합을 처리하는 가장 유사하게 입력을 처리하는 자유 형식 Search. 이 검색 API는 정식 '단일 줄 검색'입니다. 무료 양식 Search API는 POI 검색과 지오코딩의 원활한 조합입니다. 또한 API는 컨텍스트 위치(lat./lon. pair)로 가중치를 부여하거나 좌표와 반경으로 완전히 제한되거나 지리적 바이어스 앵커 포인트 없이 더 일반적으로 실행할 수 있습니다. 기본 동작은 전 세계를 검색하고 잠재적으로 불필요한 결과를 반환하기 때문에 'countrySet' 매개 변수를 사용하여 애플리케이션에 적용이 필요한 국가만 지정하는 것이 좋습니다. 예: countrySet=US,FR. 지원되는 모든 국가의 전체 목록은 [Search 적용 범위](https://docs.microsoft.com/azure/location-based-services/geocoding-coverage)를 참조하세요. 대부분의 Search 쿼리는 성능을 얻고 비정상적인 결과를 줄이기 위해 기본적으로 maxFuzzyLevel=2입니다. 이 새 기본값은 쿼리 매개 변수 maxFuzzyLevel=3 또는 4를 전달하여 요청당 필요에 따라 재정의할 수 있습니다. Get Search 유사 항목 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchfuzzy

function searchFuzzy(aborter: Aborter, query: string | GeoJSON.Position, options?: SearchFuzzyOptions): Promise<SearchFuzzyResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.

query

string | GeoJSON.Position

해당하는 쿼리 문자열(예: "seattle", "pizza")입니다. 좌표 배열 [longitude, latitude] 로 지정할 수도 있습니다(예: [-122.125679, 47.641268]).

반환

searchInsideGeometry(Aborter, string, SearchInsideGeometryRequestBody, SearchInsideGeometryOptions)

Search 기하 도형 엔드포인트를 사용하면 단일 기하 도형 또는 여러 기하 도형 내에서 자유 형식 검색을 수행할 수 있습니다. 기하 도형/기하 도형에 속하는 검색 결과가 반환됩니다. 검색할 지리적 기능은 GeoJSON FeatureCollection, The geometry 형식 중 GeoJSON 하나를 사용하여 나타내는 Polygon 및/또는 원 기하 도형으로 GeoJSON FeatureCollection 모델링할 수 있습니다. 기하 도형에 다각형과 원을 모두 포함하는 경우 이 옵션을 사용하는 것이 좋습니다. 에는 FeatureCollection 최대 50 GeoJSON Feature 개의 개체가 포함될 수 있습니다. 각 Feature 개체는 다음 조건을 가진 Polygon 또는 Circle을 나타내야 합니다. Feature Polygon 기하 도형의 개체는 최대 50개의 좌표를 가질 수 있으며 속성은 비어 있어야 합니다. Feature Circle 기하 도형의 개체는 형식을 사용하여 GeoJSON Point 표현되는 가운데와 값이 'Circle'이어야 하는 subType 속성과 함께 개체의 속성에 지정해야 하는 반경 값(미터)으로 구성됩니다. 샘플 FeatureCollection 표현은 아래 예제 섹션을 참조하세요. GeoJSON GeometryCollection, 개체 geometryGeoJSON GeometryCollection 나타낼 수 있습니다. 기하 도형에 다각형 목록만 포함된 경우 권장되는 옵션입니다. 에는 GeometryCollection 최대 50 GeoJSON Polygon 개의 개체가 포함될 수 있습니다. 각 Polygon 개체에는 최대 50개의 좌표가 있을 수 있습니다. 샘플 GeometryCollection 표현은 아래 예제 섹션을 참조하세요. GeoJSON 다각형, 개체 geometryGeoJSON Polygon 나타낼 수 있습니다. 기하 도형에 단일 다각형이 포함된 경우 권장되는 옵션입니다. 개체에는 Polygon 최대 50개의 좌표가 있을 수 있습니다. Post Search Inside Geometry API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/postsearchinsidegeometry

function searchInsideGeometry(aborter: Aborter, query: string, body: SearchInsideGeometryRequestBody, options?: SearchInsideGeometryOptions): Promise<SearchInsideGeometryResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.

query

string

해당하는 쿼리 문자열(예: "seattle", "pizza")입니다.

body
SearchInsideGeometryRequestBody

이는 검색할 하나 이상의 지리적 기능(공원, 상태 경계 등)에 대한 기하 도형을 나타내며 GeoJSON 규격 형식이어야 합니다. 자세한 내용은 RFC 7946 을 참조하세요.

반환

searchNearby(Aborter, GeoJSON.Position, SearchNearbyOptions)

주변 Search 특정 위치 주변에서 POI 결과만 검색하는 사용 사례가 있는 경우 가까운 검색 방법이 올바른 선택일 수 있습니다. 이 엔드포인트는 POI 결과만 반환하고 검색 쿼리 매개 변수를 사용하지 않습니다. 근거리 Search 가져오기 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchnearby

function searchNearby(aborter: Aborter, location: GeoJSON.Position, options?: SearchNearbyOptions): Promise<SearchNearbyResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.

location
GeoJSON.Position

결과가 편향되어야 하는 위치입니다. 의 배열[longitude, latitude]이어야 합니다(예: ). [-121.89, 37.337]

반환

searchPOI(Aborter, string, SearchPOIOptions)

이름으로 POI 가져오기 검색 사용 사례에 POI 결과만 필요한 경우 검색에 POI 엔드포인트를 사용할 수 있습니다. 이 엔드포인트는 POI 결과만 반환합니다. GET Search POI API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchpoi

function searchPOI(aborter: Aborter, query: string, options?: SearchPOIOptions): Promise<SearchPOIResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.

query

string

검색할 POI 이름(예: "자유의 여신상", "스타벅스")입니다.

반환

searchPOICategory(Aborter, string, SearchPOICategoryOptions)

범주별 POI 가져오기 검색 사용 사례에 범주별로 필터링된 POI 결과만 필요한 경우 범주 엔드포인트를 사용할 수 있습니다. 이 엔드포인트는 지정된 대로 분류된 POI 결과만 반환합니다. 사용 가능한 범주 목록은 여기에서 찾을 수 있습니다. Search POI 범주 가져오기 API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchpoicategory

function searchPOICategory(aborter: Aborter, query: string, options?: SearchPOICategoryOptions): Promise<SearchPOICategoryResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.

query

string

검색할 POI 범주입니다(예: "AIRPORT", "BEACH").

반환

searchPolygon(Aborter, string[])

Search Polygon API를 사용하면 이전에 GeoJSON 형식의 온라인 Search 요청에서 검색된 엔터티 집합에 대한 도시 또는 국가 개요와 같은 기하 도형 데이터를 요청할 수 있습니다. geometry ID는 Search Address 또는 Search 유사 항목 호출에서 "geometry" 및 "id"의 dataSources 개체에 반환됩니다. 온라인 Search 엔드포인트에서 검색된 기하 도형 ID는 수명이 제한됩니다. 이러한 식별자의 안정성이 장기간 보장되지 않으므로 클라이언트는 이후 조회를 위해 영구 스토리지에 기하 도형 ID를 저장해서는 안 됩니다. Id를 제공한 Online Search 메서드에 대한 요청 후 몇 분 이내에 Polygon 메서드에 대한 요청이 이루어질 것으로 예상됩니다. 이 서비스는 최대 20개의 식별자를 일괄 처리 요청할 수 있습니다.

Get Search Polygon API를 사용합니다.https://docs.microsoft.com/rest/api/maps/search/getsearchpolygon

function searchPolygon(aborter: Aborter, geometries: string[]): Promise<SearchPolygonResponse>

매개 변수

aborter
Aborter

요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.

geometries

string[]

이전에 온라인 Search 요청에서 검색한 기하 도형 UUID의 쉼표로 구분된 목록입니다.

반환

상속된 메서드 세부 정보

newPipeline(Credential, INewPipelineOptions)

자격 증명이 제공된 새 Pipeline 개체를 만드는 데 사용되는 정적 메서드입니다.

static function newPipeline(credential: Credential, pipelineOptions?: INewPipelineOptions): Pipeline

매개 변수

credential
Credential

SubscriptionKeyCredential, TokenCredential 및 MapControlCredential과 같은 경우

pipelineOptions
INewPipelineOptions

반환

새 Pipeline 개체입니다.

MapsURL.newPipeline에서 상속됨