Search - Get Search Fuzzy
주소 및 POI 토큰의 조합을 처리할 수 있는 검색 요청이 필요한 경우에 사용합니다.
Get Search Fuzzy
(자유 양식 검색) API는 POI 검색 및 지오코딩조합을 원활하게 처리하는 HTTP GET
요청입니다. 주소 또는 POI 토큰의 조합을 포함하는 입력의 유사 항목을 정식 '단일 줄 검색'으로 처리하는 자유 양식 검색 API입니다. 컨텍스트 위치(위도/lon 쌍)로 가중치를 부여하거나 좌표와 반지름에 의해 완전히 제한되거나 지리적 바이어싱 앵커 지점 없이 더 일반적으로 실행할 수 있습니다.
기본 동작은 전 세계를 검색하고 잠재적으로 불필요한 결과를 반환하기 때문에 'countrySet' 매개 변수를 사용하여 애플리케이션에 적용이 필요한 국가/지역만 지정하는 것이 좋습니다.
예: countrySet
=US,FR
지원되는 모든 국가/지역의 전체 목록은 검색 범위 참조하세요.
대부분의 검색 쿼리는 기본적으로 성능을 얻고 비정상적인 결과를 줄이기 위해 maxFuzzyLevel
=2로 설정됩니다. 이 새 기본값은 요청당 필요에 따라 쿼리 매개 변수 maxFuzzyLevel
=3 또는 4를 전달하여 재정의할 수 있습니다.
GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}&typeahead={typeahead}&limit={limit}&ofs={ofs}&categorySet={categorySet}&countrySet={countrySet}&lat={lat}&lon={lon}&radius={radius}&topLeft={topLeft}&btmRight={btmRight}&language={language}&extendedPostalCodesFor={extendedPostalCodesFor}&minFuzzyLevel={minFuzzyLevel}&maxFuzzyLevel={maxFuzzyLevel}&idxSet={idxSet}&brandSet={brandSet}&connectorSet={connectorSet}&entityType={entityType}&view={view}&openingHours=nextSevenDays
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
format
|
path | True |
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다. |
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호입니다. |
query
|
query | True |
string |
해당 쿼리 문자열(예: "seattle", "pizza")입니다. 또한 위도(예: "47.641268, -122.125679")로 구성된 쉼표로 구분된 문자열로 지정할 있습니다. URL을 올바르게 인코딩해야 합니다. |
brand
|
query |
string[] |
결과를 특정 브랜드로 제한하는 데 사용할 수 있는 쉼표로 구분된 브랜드 이름 목록입니다. 항목 순서는 중요하지 않습니다. 여러 브랜드가 제공되면 제공된 목록 중 하나 이상에 속하는 결과만 반환됩니다. 이름에 ""가 포함된 브랜드는 따옴표로 넣어야 합니다. 사용 예시: brandSet=Foo brandSet=Foo,Bar brandSet="A,B,C 쉼표",Bar |
|
btm
|
query |
string |
경계 상자의 오른쪽 아래 위치입니다. 예: 37.553,-122.453 |
|
category
|
query |
integer[] |
결과를 특정 관심 지점 범주로 제한하는 데 사용할 수 있는 범주 집합 ID의 쉼표로 구분된 목록입니다. ID 순서는 중요하지 않습니다. 요청당 지원되는 최대
|
|
connector
|
query |
결과를 특정 커넥터 유형을 지원하는 전기 자동차 스테이션으로 제한하는 데 사용할 수 있는 커넥터 유형의 쉼표로 구분된 목록입니다. 항목 순서는 중요하지 않습니다. 여러 커넥터 형식이 제공되면 제공된 목록 중 하나 이상에 속하는 결과만 반환됩니다. 사용 가능한 커넥터 유형은 다음과 같습니다.
사용 예시: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
||
country
|
query |
string[] |
국가/지역 코드의 쉼표로 구분된 문자열(예: FR,ES)입니다. 이렇게 하면 검색이 지정된 국가/지역으로 제한됩니다. |
|
entity
|
query |
지역에서 수행되는 필터링 수준을 지정합니다. 지정된 지리 엔터티 형식에 대한 검색 범위를 좁힐 수 있습니다( 예: 지방자치단체만 반환). 결과 응답에는 일치하는 엔터티 형식뿐만 아니라 지리 ID도 포함됩니다. 둘 이상의 엔터티를 쉼표로 구분된 목록으로 제공하는 경우 엔드포인트는 '사용 가능한 가장 작은 엔터티'를 반환합니다. 반환된 기하 도형 ID를 사용하여 검색 다각형 API 가져오기를 통해 해당 지리의 기하 도형을 가져올 수 있습니다. entityType이 설정된 경우 다음 매개 변수는 무시됩니다.
|
||
extended
|
query |
확장 우편 번호가 결과에 포함되어야 하는 인덱스입니다. 사용 가능한 인덱스는 다음과 같습니다. 추가기 = 주소 범위 지역 = 지리 PAD = 지점 주소 POI = 관심 지점 Str = Streets XStr = 교차로(교차로) 값은 인덱스 형식의 쉼표로 구분된 목록(순서에 관계없이)이거나 인덱스가 없는 경우 None 합니다. 기본적으로 확장 우편 번호는 Geo를 제외한 모든 인덱스에 포함됩니다. 지리에 대한 확장 우편 번호 목록은 매우 길 수 있으므로 필요할 때 명시적으로 요청해야 합니다. 사용 예시: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None 확장 우편 번호는 주소의 extendedPostalCode 속성으로 반환됩니다. 가용성은 지역에 따라 다릅니다. |
||
idx
|
query |
검색에 사용해야 하는 쉼표로 구분된 인덱스 목록입니다. 항목 순서는 중요하지 않습니다. 사용 가능한 인덱스는 다음과 같습니다. Addr = 주소 범위 보간, 지리적 = 지리, PAD = 지점 주소, POI = 관심 지점, Str = 거리, Xstr = 교차로 (교차로) |
||
language
|
query |
string |
검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다. 자세한 내용은 지원되는 언어 참조하세요. |
|
lat
|
query |
number (double) |
결과가 편향되어야 하는 위도입니다. 예: 37.337 |
|
limit
|
query |
integer minimum: 1maximum: 100 |
반환될 최대 응답 수입니다. 기본값: 10, 최소: 1 및 최대: 100 |
|
lon
|
query |
number (double) |
결과가 편향되어야 하는 경도입니다. 예: -121.89 |
|
max
|
query |
integer minimum: 1maximum: 4 |
사용할 최대 유사 항목 수준입니다. 기본값: 2, 최소: 1 및 최대: 4
검색 엔진은 minFuzzyLevel에 정의된 수준에서 일치 항목을 찾기 시작하고 maxFuzzyLevel에 지정된 수준에서 검색을 중지합니다. |
|
min
|
query |
integer minimum: 1maximum: 4 |
사용할 최소 유사 항목 수준입니다. 기본값: 1, 최소: 1 및 최대: 4
검색 엔진은 minFuzzyLevel에 정의된 수준에서 일치 항목을 찾기 시작하고 maxFuzzyLevel에 지정된 수준에서 검색을 중지합니다. |
|
ofs
|
query |
integer minimum: 0maximum: 1900 |
전체 결과 집합 내에서 반환된 결과의 시작 오프셋입니다. 기본값: 0 |
|
opening
|
query |
POI에 대한 작업 시간(관심 지점). 작업 시간의 가용성은 사용 가능한 데이터에 따라 달라집니다. 전달되지 않으면 영업 시간 정보가 반환되지 않습니다. 지원되는 값: nextSevenDays |
||
radius
|
query |
integer |
결과가 정의된 영역으로 제한될 반경(미터)입니다. |
|
top
|
query |
string |
경계 상자의 왼쪽 위 위치입니다. 예: 37.553,-122.453 |
|
typeahead
|
query |
boolean |
부울. typeahead 플래그가 설정되면 쿼리가 부분 입력으로 해석되고 검색이 예측 모드로 전환됩니다. |
|
view
|
query |
View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps의 View 매개 변수는 Azure Maps를 통해 액세스할 수 있는 권한이 있는 지도, 이미지 및 기타 데이터 및 타사 콘텐츠를 사용할 수 있는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN. 자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요. |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하려면 지침에 대한 다음 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
그래 |
|
Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름에
시나리오를 구현하려면
메모
- 이 보안 정의
x-ms-client-id
헤더를 사용하여 애플리케이션이 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API에서 가져올 수 있습니다. -
Authorization URL
Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. - Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해
Azure 관리 평면에서 구성됩니다. - Azure Maps Web SDK 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요참조하세요.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Azure Portal에서 Azure Maps 계정 만들거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정에서 마스터 키로 사용할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 키를 안전하게 저장할 수 있도록 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 Azure Maps REST API에 액세스하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
query
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
예제
Search City Seattle
샘플 요청
GET https://atlas.microsoft.com/search/fuzzy/json?api-version=1.0&query=seattle&openingHours=nextSevenDays
샘플 응답
{
"summary": {
"query": "seattle",
"queryType": "NON_NEAR",
"queryTime": 66,
"numResults": 10,
"offset": 0,
"totalResults": 3720,
"fuzzyLevel": 1
},
"results": [
{
"type": "Geography",
"id": "US/GEO/p0/188055",
"score": 2.531,
"entityType": "Municipality",
"address": {
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle",
"countrySubdivisionCode": "WA",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Seattle, WA",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.60323,
"lon": -122.33028
},
"viewport": {
"topLeftPoint": {
"lat": 47.7344,
"lon": -122.4594
},
"btmRightPoint": {
"lat": 47.48106,
"lon": -122.22497
}
},
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-0000596ae8ed"
}
}
},
{
"type": "Geography",
"id": "US/GEO/p0/183911",
"score": 2.382,
"entityType": "Municipality",
"address": {
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countrySubdivisionCode": "WA",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Seattle, WA",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.55342,
"lon": -122.25007
},
"viewport": {
"topLeftPoint": {
"lat": 47.58995,
"lon": -122.26723
},
"btmRightPoint": {
"lat": 47.5169,
"lon": -122.23291
}
},
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-00006553f33d"
}
}
},
{
"type": "POI",
"id": "ZA/POI/p0/449288",
"score": 2.226,
"info": "search:ta:710009004165863-ZA",
"poi": {
"name": "Seattle Coffee Co - Groote Kerk Sentrum",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Kloof Street",
"municipalitySubdivision": "Cape Town",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "8001",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Kloof Street, Gardens, City of Cape Town, Western Cape, 8001",
"localName": "Gardens"
},
"position": {
"lat": -33.92917,
"lon": 18.41178
},
"viewport": {
"topLeftPoint": {
"lat": -33.92827,
"lon": 18.4107
},
"btmRightPoint": {
"lat": -33.93007,
"lon": 18.41286
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -33.92907,
"lon": 18.41162
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/449396",
"score": 2.226,
"info": "search:ta:710009004163591-ZA",
"poi": {
"name": "Seattle Coffee Co - Pietermaritzburg",
"phone": "+(27)-(33)-3458486",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "9",
"streetName": "Armitage Road",
"municipalitySubdivision": "Pietermaritzburg City, Pietermaritzburg",
"municipality": "Pietermaritzburg",
"countrySecondarySubdivision": "The Msunduzi",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "3201",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Armitage Road 9, Athlone, The Msunduzi, KwaZulu-Natal, 3201",
"localName": "Athlone"
},
"position": {
"lat": -29.58611,
"lon": 30.37508
},
"viewport": {
"topLeftPoint": {
"lat": -29.58521,
"lon": 30.37405
},
"btmRightPoint": {
"lat": -29.58701,
"lon": 30.37611
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -29.58668,
"lon": 30.37531
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/451868",
"score": 2.226,
"info": "search:ta:710009002195538-ZA",
"poi": {
"name": "Seattle Coffee Co - Bedford Village",
"phone": "+(27)-(84)-5451111",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Van Buuren Road",
"municipalitySubdivision": "Bedfordview",
"municipality": "Germiston",
"countrySecondarySubdivision": "Ekurhuleni",
"countrySubdivisionCode": "Gauteng",
"postalCode": "2007",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Van Buuren Road, Bedfordview, Ekurhuleni, Gauteng, 2007",
"localName": "Bedfordview"
},
"position": {
"lat": -26.18009,
"lon": 28.13544
},
"viewport": {
"topLeftPoint": {
"lat": -26.17919,
"lon": 28.13444
},
"btmRightPoint": {
"lat": -26.18099,
"lon": 28.13644
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -26.18006,
"lon": 28.13636
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/488888",
"score": 2.226,
"info": "search:ta:710009002102639-ZA",
"poi": {
"name": "Seattle Coffee Co - Caltex Starstop Milly's",
"phone": "+(27)-(13)-2560340",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipality": "Wonderfontein",
"countrySecondarySubdivision": "Emakhazeni",
"countrySubdivisionCode": "Mpumalanga",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Wonderfontein, Emakhazeni, Mpumalanga"
},
"position": {
"lat": -25.68842,
"lon": 30.21291
},
"viewport": {
"topLeftPoint": {
"lat": -25.68752,
"lon": 30.21191
},
"btmRightPoint": {
"lat": -25.68932,
"lon": 30.21391
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -25.68913,
"lon": 30.21343
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/489433",
"score": 2.226,
"info": "search:ta:710009002184068-ZA",
"poi": {
"name": "Seattle Coffee Co - Southcoast Mall",
"phone": "+(27)-(39)-3150816",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipalitySubdivision": "Shelly Beach",
"municipality": "Shelly Beach",
"countrySecondarySubdivision": "Hibiscus Coast",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "4265",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
"localName": "Shelly Beach"
},
"position": {
"lat": -30.79937,
"lon": 30.40569
},
"viewport": {
"topLeftPoint": {
"lat": -30.79847,
"lon": 30.40464
},
"btmRightPoint": {
"lat": -30.80027,
"lon": 30.40674
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -30.7994,
"lon": 30.40618
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/489976",
"score": 2.226,
"info": "search:ta:710009004261897-ZA",
"poi": {
"name": "Seattle Cofee Co",
"phone": "+(27)-(39)-3150816",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipalitySubdivision": "Shelly Beach",
"municipality": "Shelly Beach",
"countrySecondarySubdivision": "Hibiscus Coast",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "4265",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
"localName": "Shelly Beach"
},
"position": {
"lat": -30.79801,
"lon": 30.40557
},
"viewport": {
"topLeftPoint": {
"lat": -30.79711,
"lon": 30.40452
},
"btmRightPoint": {
"lat": -30.79891,
"lon": 30.40662
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -30.79784,
"lon": 30.40523
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/490056",
"score": 2.226,
"info": "search:ta:710009004149612-ZA",
"poi": {
"name": "Seattle Coffee Co - Constantia Village",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Constantia Main Road",
"municipalitySubdivision": "Cape Town",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "7708",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Constantia Main Road, Constantia, City of Cape Town, Western Cape, 7708",
"localName": "Constantia"
},
"position": {
"lat": -34.02087,
"lon": 18.44503
},
"viewport": {
"topLeftPoint": {
"lat": -34.01997,
"lon": 18.44394
},
"btmRightPoint": {
"lat": -34.02177,
"lon": 18.44612
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -34.02017,
"lon": 18.44476
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/494340",
"score": 2.226,
"info": "search:ta:710009004152570-ZA",
"poi": {
"name": "Seattle Coffee Co - Canal Walk Shopping Centre",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Century Boulevard",
"municipalitySubdivision": "Milnerton",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "7441",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Century Boulevard, Century City, City of Cape Town, Western Cape, 7441",
"localName": "Century City"
},
"position": {
"lat": -33.89348,
"lon": 18.5122
},
"viewport": {
"topLeftPoint": {
"lat": -33.89258,
"lon": 18.51112
},
"btmRightPoint": {
"lat": -33.89438,
"lon": 18.51328
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -33.8943,
"lon": 18.51328
}
}
]
}
]
}
정의
Name | Description |
---|---|
Address |
결과의 주소입니다. |
Address |
검색 결과에 대한 거리 양쪽의 주소 범위를 설명합니다. 주소 범위의 시작 및 끝 위치에 대한 좌표가 포함됩니다. |
Bounding |
뷰포트의 왼쪽 위와 오른쪽 아래 좌표로 표시되는 결과를 포함하는 뷰포트입니다. |
Bounding |
위치의 경계 상자입니다. |
Brand |
POI와 연결된 브랜드 |
Classification |
반환되는 POI에 대한 분류 |
Classification |
분류의 이름 |
Data |
선택적 섹션입니다. 검색 다각형 API 가져오기 사용할 참조 ID입니다. |
Electric |
결과를 특정 커넥터 유형을 지원하는 전기 자동차 스테이션으로 제한하는 데 사용할 수 있는 커넥터 유형의 쉼표로 구분된 목록입니다. 항목 순서는 중요하지 않습니다. 여러 커넥터 형식이 제공되면 제공된 목록 중 하나 이상에 속하는 결과만 반환됩니다. 사용 가능한 커넥터 유형은 다음과 같습니다.
사용 예시: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
Entity |
경계 상자의 엔터티 형식 원본입니다. 역방향 지오코딩의 경우 항상 위치와 같습니다. |
Entry |
반환되는 POI의 진입점입니다. |
Entry |
진입점의 형식입니다. 값은 주 또는 부 수 있습니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Geographic |
Geography 엔터티 형식입니다. entityType이 요청되어 사용 가능한 경우에만 표시됩니다. |
Geometry |
결과의 기하학적 모양에 대한 정보입니다. == Geography 형식인 경우에만 존재합니다. |
Lat |
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다. |
Localized |
View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps의 View 매개 변수는 Azure Maps를 통해 액세스할 수 있는 권한이 있는 지도, 이미지 및 기타 데이터 및 타사 콘텐츠를 사용할 수 있는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN. 자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요. |
Match |
역방향 주소 검색 작업에 대한 일치 유형입니다. |
Operating |
POI의 영업 시간(관심 지점). |
Operating |
POI에 대한 작업 시간(관심 지점). 작업 시간의 가용성은 사용 가능한 데이터에 따라 달라집니다. 전달되지 않으면 영업 시간 정보가 반환되지 않습니다. 지원되는 값: nextSevenDays |
Operating |
날짜 및 시간을 나타냅니다. |
Operating |
하루의 여는 시간 범위 |
Point |
이름, 전화, URL 주소 및 분류와 같은 정보를 포함하여 반환된 POI의 세부 정보입니다. |
Point |
POI 범주 |
Query |
반환되는 쿼리 유형: NEARBY 또는 NON_NEAR. |
Response |
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다. |
Search |
이 개체는 성공적인 검색 호출에서 반환됩니다. |
Search |
Search API 응답에 대한 결과 개체입니다. |
Search |
다음 중 하나입니다.
|
Search |
확장 우편 번호가 결과에 포함되어야 하는 인덱스입니다. 사용 가능한 인덱스는 다음과 같습니다. 추가기 = 주소 범위 지역 = 지리 PAD = 지점 주소 POI = 관심 지점 Str = Streets XStr = 교차로(교차로) 값은 인덱스 형식의 쉼표로 구분된 목록(순서에 관계없이)이거나 인덱스가 없는 경우 None 합니다. 기본적으로 확장 우편 번호는 Geo를 제외한 모든 인덱스에 포함됩니다. 지리에 대한 확장 우편 번호 목록은 매우 길 수 있으므로 필요할 때 명시적으로 요청해야 합니다. 사용 예시: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None 확장 우편 번호는 주소의 extendedPostalCode 속성으로 반환됩니다. 가용성은 지역에 따라 다릅니다. |
Search |
Search API 응답에 대한 요약 개체입니다. |
Address
결과의 주소입니다.
Name | 형식 | Description |
---|---|---|
boundingBox |
위치의 경계 상자입니다. |
|
buildingNumber |
string |
거리의 건물 번호입니다. 사용되지 않습니다. 대신 streetNumber를 사용합니다. |
country |
string |
국가/지역 이름 |
countryCode |
string |
국가(참고: 국가/지역 이름이 아닌 두 글자 코드입니다.) |
countryCodeISO3 |
string |
ISO alpha-3 국가 코드 |
countrySecondarySubdivision |
string |
군 |
countrySubdivision |
string |
주 또는 도 |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
국가/지역 관리 계층 구조의 첫 번째 수준의 전체 이름입니다. 이 필드는 countrySubdivision이 약어 형식으로 표시되는 경우에만 나타납니다. 미국, 캐나다 및 영국에서만 지원됩니다. |
countryTertiarySubdivision |
string |
명명된 영역 |
crossStreet |
string |
교차되는 거리의 이름입니다. |
extendedPostalCode |
string |
확장 우편 번호(가용성은 지역에 따라 다름). |
freeformAddress |
string |
결과 국가/원본 지역의 서식 규칙에 따라 또는 국가/지역의 경우 전체 국가/지역 이름에 따라 서식이 지정된 주소 줄입니다. |
localName |
string |
관리 단위가 아닌 주소 지정을 위해 주소 지정 가능한 여러 개체를 그룹화한 지리적 영역 또는 지역 이름을 나타내는 주소 구성 요소입니다. 이 필드는 |
municipality |
string |
City / Town |
municipalitySubdivision |
string |
서브/슈퍼 시티 |
neighbourhood |
string |
이웃은 독특한 특성과 주민 간의 사회적 상호 작용을 가진 도시 또는 마을 내에서 지리적으로 지역화 된 지역입니다. |
postalCode |
string |
우편 번호 / 우편 번호 |
routeNumbers |
string[] |
거리를 명확하게 식별하는 데 사용되는 코드 |
street |
string |
거리 이름입니다. 사용되지 않습니다. 대신 streetName을 사용합니다. |
streetName |
string |
거리 이름입니다. |
streetNameAndNumber |
string |
거리 이름 및 번호입니다. |
streetNumber |
string |
거리의 건물 번호입니다. |
AddressRanges
검색 결과에 대한 거리 양쪽의 주소 범위를 설명합니다. 주소 범위의 시작 및 끝 위치에 대한 좌표가 포함됩니다.
Name | 형식 | Description |
---|---|---|
from |
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다. |
|
rangeLeft |
string |
거리의 왼쪽에 있는 주소 범위입니다. |
rangeRight |
string |
거리의 오른쪽에 있는 주소 범위입니다. |
to |
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다. |
BoundingBox
뷰포트의 왼쪽 위와 오른쪽 아래 좌표로 표시되는 결과를 포함하는 뷰포트입니다.
Name | 형식 | Description |
---|---|---|
btmRightPoint |
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다. |
|
topLeftPoint |
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다. |
BoundingBoxCompassNotation
위치의 경계 상자입니다.
Name | 형식 | Description |
---|---|---|
entity |
경계 상자의 엔터티 형식 원본입니다. 역방향 지오코딩의 경우 항상 위치와 같습니다. |
|
northEast |
string |
북동 위도, 경계 상자의 경도 좌표(쉼표로 구분된 부동 소수로) |
southWest |
string |
남서 위도, 경계 상자의 경도 좌표(쉼표로 구분된 부동 소수로) |
Brand
POI와 연결된 브랜드
Name | 형식 | Description |
---|---|---|
name |
string |
브랜드 이름 |
Classification
반환되는 POI에 대한 분류
Name | 형식 | Description |
---|---|---|
code |
string |
코드 속성 |
names |
이름 배열 |
ClassificationName
분류의 이름
Name | 형식 | Description |
---|---|---|
name |
string |
Name 속성 |
nameLocale |
string |
Name Locale 속성 |
DataSources
선택적 섹션입니다. 검색 다각형 API 가져오기 사용할 참조 ID입니다.
Name | 형식 | Description |
---|---|---|
geometry |
결과의 기하학적 모양에 대한 정보입니다. == Geography 형식인 경우에만 존재합니다. |
ElectricVehicleConnector
결과를 특정 커넥터 유형을 지원하는 전기 자동차 스테이션으로 제한하는 데 사용할 수 있는 커넥터 유형의 쉼표로 구분된 목록입니다. 항목 순서는 중요하지 않습니다. 여러 커넥터 형식이 제공되면 제공된 목록 중 하나 이상에 속하는 결과만 반환됩니다.
사용 가능한 커넥터 유형은 다음과 같습니다.
-
StandardHouseholdCountrySpecific
- 특정 지역의 표준 가정용 커넥터입니다. 모두 AC 단일 단계이며 표준 전압 및 표준 앰퍼리지입니다. 참고 항목: 플러그 & 소켓 유형 - 세계 표준. -
IEC62196Type1
- IEC 62196-2 표준에 정의된 형식 1 커넥터입니다. 또한 처음 게시 표준 후 원래 제조 업체 또는 SAE J1772 후 야자키라고. 대부분 120V 단일 단계 또는 최대 240V 단일 단계 인프라와 함께 사용됩니다. -
IEC62196Type1CCS
- IEC 62196-3 표준에 정의된 형식 1 기반 콤보 커넥터입니다. 커넥터는 IEC 62196-2 표준에 정의된 형식 1 커넥터를 기반으로 하며 DC 빠른 충전을 허용하는 두 개의 DC(직접 전류) 연락처가 추가로 있습니다. -
IEC62196Type2CableAttached
- IEC 62196-2 표준에 정의된 형식 2 커넥터입니다. 충전 지점에 연결된 케이블 및 플러그로 제공됩니다. -
IEC62196Type2Outlet
- IEC 62196-2 표준에 정의된 형식 2 커넥터입니다. 충전 지점에 소켓 세트로 제공됩니다. -
IEC62196Type2CCS
- IEC 62196-3 표준에 정의된 형식 2 기반 콤보 커넥터입니다. 커넥터는 IEC 62196-2 표준에 정의된 형식 2 커넥터를 기반으로 하며 DC 고속 충전을 허용하는 두 개의 DC(직접 전류) 연락처가 추가로 있습니다. -
IEC62196Type3
- IEC 62196-2 표준에 정의된 형식 3 커넥터입니다. 또한 원래 제조 업체 후 S가되었다라고합니다. 대부분 최대 240V 단일 단계 또는 최대 420V 3단계 인프라와 함께 사용됩니다. -
Chademo
- 도쿄 전력 회사와 산업 파트너가 형성 한 협회의 이름을 따서 명명 된 CHAdeMO 커넥터. 이 때문에 TEPCO의 커넥터라고도 합니다. 빠른 DC 충전을 지원합니다. -
IEC60309AC1PhaseBlue
- 인더스트리얼 블루 커넥터는 IEC 60309 표준에 정의된 커넥터입니다. 표준, 색 및 단일 단계 커넥터라는 사실의 일부 조합으로도 불립니다. 커넥터에는 일반적으로 "P+N+E, 6h" 구성이 있습니다. -
IEC60309DCWhite
- 산업용 화이트 커넥터는 IEC 60309 표준에 정의된 DC 커넥터입니다. -
Tesla
- Tesla 커넥터는 지역별 특정 Tesla 슈퍼차저 커넥터입니다. 즉, Tesla의 독점 커넥터를 의미하며, 일반적으로 북미로 제한되는 Tesla 포트 또는 유럽의 수정된 Type 2(형식 2를 통해 DC)라고도 합니다.
사용 예시:
connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
값 | Description |
---|---|
Chademo |
도쿄 전력 회사와 산업 파트너가 결성한 협회의 이름을 따서 명명된 CHAdeMO 커넥터. 이 때문에 TEPCO의 커넥터라고도 합니다. 빠른 DC 충전을 지원합니다. |
IEC60309AC1PhaseBlue |
인더스트리얼 블루 커넥터는 IEC 60309 표준에 정의된 커넥터입니다. 표준, 색 및 단일 단계 커넥터라는 사실의 일부 조합으로도 불립니다. 커넥터에는 일반적으로 "P+N+E, 6h" 구성이 있습니다. |
IEC60309DCWhite |
인더스트리얼 화이트 커넥터는 IEC 60309 표준에 정의된 DC 커넥터입니다. |
IEC62196Type1 |
IEC 62196-2 표준에 정의된 형식 1 커넥터입니다. 또한 처음 게시 표준 후 원래 제조 업체 또는 SAE J1772 후 야자키라고. 대부분 120V 단일 단계 또는 최대 240V 단일 단계 인프라와 함께 사용됩니다. |
IEC62196Type1CCS |
IEC 62196-3 표준에 정의된 형식 1 기반 콤보 커넥터입니다. 커넥터는 IEC 62196-2 표준에 정의된 형식 1 커넥터를 기반으로 하며 DC 빠른 충전을 허용하는 두 개의 DC(직접 전류) 연락처가 추가로 있습니다. |
IEC62196Type2CCS |
IEC 62196-3 표준에 정의된 형식 2 기반 콤보 커넥터입니다. 커넥터는 IEC 62196-2 표준에 정의된 형식 2 커넥터를 기반으로 하며 DC 고속 충전을 허용하는 두 개의 DC(직접 전류) 연락처가 추가로 있습니다. |
IEC62196Type2CableAttached |
IEC 62196-2 표준에 정의된 형식 2 커넥터입니다. 충전 지점에 연결된 케이블 및 플러그로 제공 |
IEC62196Type2Outlet |
IEC 62196-2 표준에 정의된 형식 2 커넥터입니다. 충전 지점에 소켓 세트로 제공됩니다. |
IEC62196Type3 |
IEC 62196-2 표준에 정의된 형식 3 커넥터입니다. 또한 원래 제조 업체 후 S가되었다라고합니다. 대부분 최대 240V 단일 단계 또는 최대 420V 3단계 인프라와 함께 사용됩니다. |
StandardHouseholdCountrySpecific |
이러한 커넥터는 특정 지역의 표준 가정용 커넥터입니다. 모두 AC 단일 단계이며 표준 전압 및 표준 앰퍼리지입니다. 참고 항목: 플러그 & 소켓 유형 - 세계 표준 |
Tesla |
Tesla 커넥터는 지역별 Tesla 슈퍼차저 커넥터입니다. 즉, Tesla의 독점 커넥터를 의미하며, 일반적으로 북미로 제한되는 Tesla 포트 또는 유럽의 수정된 Type 2(형식 2를 통해 DC)라고도 합니다. |
Entity
경계 상자의 엔터티 형식 원본입니다. 역방향 지오코딩의 경우 항상 위치와 같습니다.
값 | Description |
---|---|
position |
위치 엔터티 |
EntryPoint
반환되는 POI의 진입점입니다.
Name | 형식 | Description |
---|---|---|
position |
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다. |
|
type |
진입점의 형식입니다. 값은 주 또는 부 수 있습니다. |
EntryPointType
진입점의 형식입니다. 값은 주 또는 부 수 있습니다.
값 | Description |
---|---|
main | |
minor |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
GeographicEntityType
Geography 엔터티 형식입니다. entityType이 요청되어 사용 가능한 경우에만 표시됩니다.
값 | Description |
---|---|
Country |
국가/지역 이름 |
CountrySecondarySubdivision |
군 |
CountrySubdivision |
주 또는 도 |
CountryTertiarySubdivision |
명명된 영역 |
Municipality |
City / Town |
MunicipalitySubdivision |
서브/슈퍼 시티 |
Neighbourhood |
지역 |
PostalCodeArea |
우편 번호 / 우편 번호 |
Geometry
결과의 기하학적 모양에 대한 정보입니다. == Geography 형식인 경우에만 존재합니다.
Name | 형식 | Description |
---|---|---|
id |
string |
이 결과를 위해 기하 도형 정보를 가져오는 검색 다각형 API에 geometryId로 전달합니다. |
LatLongPairAbbreviated
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다.
Name | 형식 | Description |
---|---|---|
lat |
number (double) |
위도 속성 |
lon |
number (double) |
경도 속성 |
LocalizedMapView
View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps의 View 매개 변수는 Azure Maps를 통해 액세스할 수 있는 권한이 있는 지도, 이미지 및 기타 데이터 및 타사 콘텐츠를 사용할 수 있는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN.
자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요.
값 | Description |
---|---|
AE |
아랍에미리트(아랍어 보기) |
AR |
아르헨티나(아르헨티나 뷰) |
Auto |
요청의 IP 주소를 기반으로 맵 데이터를 반환합니다. |
BH |
바레인(아랍어 보기) |
IN |
인도(인도 보기) |
IQ |
이라크(아랍어 보기) |
JO |
요르단(아랍어 보기) |
KW |
쿠웨이트(아랍어 보기) |
LB |
레바논(아랍어 보기) |
MA |
모로코(모로코 전망) |
OM |
오만어(아랍어 보기) |
PK |
파키스탄(파키스탄 뷰) |
PS |
팔레스타인 자치(아랍어 보기) |
QA |
카타르(아랍어 보기) |
SA |
사우디아라비아(아랍어 보기) |
SY |
시리아(아랍어 보기) |
Unified |
통합 보기(기타) |
YE |
예멘(아랍어 보기) |
MatchType
역방향 주소 검색 작업에 대한 일치 유형입니다.
값 | Description |
---|---|
AddressPoint | |
HouseNumberRange | |
Street |
OperatingHours
POI의 영업 시간(관심 지점).
Name | 형식 | Description |
---|---|---|
mode |
string |
요청에 사용된 값: none 또는 "nextSevenDays" |
timeRanges |
다음 7일 동안의 시간 범위 목록 |
OperatingHoursRange
POI에 대한 작업 시간(관심 지점). 작업 시간의 가용성은 사용 가능한 데이터에 따라 달라집니다. 전달되지 않으면 영업 시간 정보가 반환되지 않습니다. 지원되는 값: nextSevenDays
값 | Description |
---|---|
nextSevenDays |
POI의 현지 시간에서 현재 날짜부터 시작하여 다음 주에 대한 작업 시간을 표시합니다. |
OperatingHoursTime
날짜 및 시간을 나타냅니다.
Name | 형식 | Description |
---|---|---|
date |
string |
POI 표준 시간대의 현재 달력 날짜(예: "2019-02-07")를 나타냅니다. |
hour |
integer |
시간은 POI의 현지 시간에 24시간 형식입니다. 가능한 값은 0 - 23입니다. |
minute |
integer |
분은 POI의 현지 시간에 있습니다. 가능한 값은 0 - 59입니다. |
OperatingHoursTimeRange
하루의 여는 시간 범위
Name | 형식 | Description |
---|---|---|
endTime |
지정된 POI를 닫을 때 다음 7일 범위의 지점이거나 범위 이전에 닫힌 경우 범위의 시작점입니다. |
|
startTime |
지정된 POI를 열 때 다음 7일 범위의 지점이거나 범위 이전에 열린 경우 범위의 시작점입니다. |
PointOfInterest
이름, 전화, URL 주소 및 분류와 같은 정보를 포함하여 반환된 POI의 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
brands |
Brand[] |
브랜드 배열입니다. 반환되는 POI의 브랜드 이름입니다. |
categories |
string[] |
범주 배열 |
categorySet |
가장 구체적인 POI 범주 목록 |
|
classifications |
분류 배열 |
|
name |
string |
POI 속성의 이름 |
openingHours |
POI의 영업 시간(관심 지점). |
|
phone |
string |
전화 번호 속성 |
url |
string |
웹 사이트 URL 속성 |
PointOfInterestCategorySet
POI 범주
Name | 형식 | Description |
---|---|---|
id |
integer |
범주 ID |
QueryType
반환되는 쿼리 유형: NEARBY 또는 NON_NEAR.
값 | Description |
---|---|
NEARBY |
정의된 반지름을 사용하여 특정 위도 및 경도를 중심으로 검색을 수행했습니다. |
NON_NEAR |
검색은 특정 위도 및 경도에 편향되지 않고 전역적으로 수행되었으며 정의된 반경이 없습니다. |
ResponseFormat
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다.
값 | Description |
---|---|
json | |
xml |
SearchAddressResult
이 개체는 성공적인 검색 호출에서 반환됩니다.
Name | 형식 | Description |
---|---|---|
results |
검색 API 결과 목록입니다. |
|
summary |
Search API 응답에 대한 요약 개체 |
SearchAddressResultItem
Search API 응답에 대한 결과 개체입니다.
Name | 형식 | Description |
---|---|---|
address |
결과의 주소입니다. |
|
addressRanges |
검색 결과에 대한 거리 양쪽의 주소 범위를 설명합니다. 주소 범위의 시작 및 끝 위치에 대한 좌표가 포함됩니다. |
|
dataSources |
선택적 섹션입니다. Get Search 다각형 API와 함께 사용할 기하 도형 ID를 참조합니다. |
|
detourTime |
integer |
우회 시간(초)입니다. 경로 API를 따라 검색에 대한 호출에 대해서만 반환됩니다. |
dist |
number (double) |
결과와 지오비아 위치 사이의 직선 거리(미터)입니다. |
entityType |
Geography 엔터티 형식입니다. entityType이 요청되어 사용 가능한 경우에만 표시됩니다. |
|
entryPoints |
EntryPoint의 배열입니다. 이들은 위치에서 사용할 수있는 입구의 유형을 설명합니다. 이 유형은 정문 또는 로비와 같은 정문의 경우 "main"이고 측면 및 뒷문의 경우 "부"일 수 있습니다. |
|
id |
string |
Id 속성 |
info |
string |
결과의 원래 데이터 원본에 대한 정보입니다. 지원 요청에 사용됩니다. |
matchType |
일치 유형에 대한 정보입니다. 다음 중 하나입니다.
|
|
poi |
이름, 전화, URL 주소 및 분류와 같은 정보를 포함하여 반환된 POI의 세부 정보입니다. |
|
position |
짧은 이름 '위도'& 'lon'을 사용하여 위도 및 경도로 표시되는 위치입니다. |
|
score |
number (double) |
결과 집합 내의 값으로, 결과 간의 상대 일치 점수를 나타냅니다. x 값이 y 값의 2배인 경우 결과 x가 결과 y보다 두 배 더 관련성이 있다고 판단하는 데 사용할 수 있습니다. 값은 쿼리마다 다르며 하나의 결과 집합에 대한 상대 값으로만 사용됩니다. |
type |
다음 중 하나입니다.
|
|
viewport |
뷰포트의 왼쪽 위와 오른쪽 아래 좌표로 표시되는 결과를 포함하는 뷰포트입니다. |
SearchAddressResultType
다음 중 하나입니다.
- POI
- 거리
- 지리학
- 지점 주소
- 주소 범위
- 교차로
값 | Description |
---|---|
Address Range | |
Cross Street | |
Geography | |
POI | |
Point Address | |
Street |
SearchIndexes
확장 우편 번호가 결과에 포함되어야 하는 인덱스입니다.
사용 가능한 인덱스는 다음과 같습니다.
추가기 = 주소 범위
지역 = 지리
PAD = 지점 주소
POI = 관심 지점
Str = Streets
XStr = 교차로(교차로)
값은 인덱스 형식의 쉼표로 구분된 목록(순서에 관계없이)이거나 인덱스가 없는 경우 None 합니다.
기본적으로 확장 우편 번호는 Geo를 제외한 모든 인덱스에 포함됩니다. 지리에 대한 확장 우편 번호 목록은 매우 길 수 있으므로 필요할 때 명시적으로 요청해야 합니다.
사용 예시:
extendedPostalCodesFor=POI
extendedPostalCodesFor=PAD,Addr,POI
extendedPostalCodesFor=None
확장 우편 번호는 주소의 extendedPostalCode 속성으로 반환됩니다. 가용성은 지역에 따라 다릅니다.
값 | Description |
---|---|
Addr | |
Geo | |
PAD | |
POI | |
Str | |
Xstr |
SearchSummary
Search API 응답에 대한 요약 개체입니다.
Name | 형식 | Description |
---|---|---|
fuzzyLevel |
integer |
결과를 제공하는 데 필요한 최대 유사 항목 수준입니다. |
geoBias |
내부 검색 엔진이 지리 공간적 편향을 적용하여 결과 순위를 향상한 경우를 나타냅니다. 일부 메서드에서는 사용 가능한 경우 위도 및 lon 매개 변수를 설정하여 영향을 받을 수 있습니다. 다른 경우에는 순전히 내부입니다. |
|
limit |
integer |
반환될 최대 응답 수 |
numResults |
integer |
응답의 결과 수입니다. |
offset |
integer |
전체 결과 집합 내에서 반환된 결과의 시작 오프셋입니다. |
query |
string |
이러한 검색 결과를 생성하는 데 사용된 쿼리 매개 변수입니다. |
queryTime |
integer |
쿼리를 확인하는 데 소요된 시간(밀리초)입니다. |
queryType |
반환되는 쿼리 유형: NEARBY 또는 NON_NEAR. |
|
totalResults |
integer |
찾은 총 결과 수입니다. |