Search - Get Search Nearby
특정 위치 근처에서 관심 지점을 검색하는 데 사용합니다.
Get Search Nearby
API는 특정 위치 주위에 POI 결과를 검색하는 데 가장 유용한 HTTP GET
요청입니다. 이 엔드포인트는 POI 결과만 반환하며 검색 쿼리 매개 변수를 사용하지 않습니다.
GET https://atlas.microsoft.com/search/nearby/{format}?api-version=1.0&lat={lat}&lon={lon}
GET https://atlas.microsoft.com/search/nearby/{format}?api-version=1.0&lat={lat}&lon={lon}&limit={limit}&ofs={ofs}&categorySet={categorySet}&countrySet={countrySet}&radius={radius}&language={language}&extendedPostalCodesFor={extendedPostalCodesFor}&brandSet={brandSet}&connectorSet={connectorSet}&view={view}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
format
|
path | True |
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다. |
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호입니다. |
lat
|
query | True |
number (double) |
결과가 편향되어야 하는 위도입니다. 예: 37.337. |
lon
|
query | True |
number (double) |
결과가 편향되어야 하는 경도입니다. 예: -121.89. |
brand
|
query |
string[] |
결과를 특정 브랜드로 제한하는 데 사용할 수 있는 쉼표로 구분된 브랜드 이름 목록입니다. 항목 순서는 중요하지 않습니다. 여러 브랜드가 제공되면 제공된 목록 중 하나 이상에 속하는 결과만 반환됩니다. 이름에 ""가 포함된 브랜드는 따옴표로 넣어야 합니다. 사용 예시: brandSet=Foo brandSet=Foo,Bar brandSet="A,B,C 쉼표",Bar |
|
category
|
query |
integer[] |
결과를 특정 관심 지점 범주로 제한하는 데 사용할 수 있는 범주 집합 ID의 쉼표로 구분된 목록입니다. ID 순서는 중요하지 않습니다. 요청당 지원되는 최대
|
|
connector
|
query |
결과를 특정 커넥터 유형을 지원하는 전기 자동차 스테이션으로 제한하는 데 사용할 수 있는 커넥터 유형의 쉼표로 구분된 목록입니다. 항목 순서는 중요하지 않습니다. 여러 커넥터 형식이 제공되면 제공된 목록 중 하나 이상에 속하는 결과만 반환됩니다. 사용 가능한 커넥터 유형은 다음과 같습니다.
사용 예시: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
||
country
|
query |
string[] |
국가/지역 코드의 쉼표로 구분된 문자열(예: FR,ES)입니다. 이렇게 하면 검색이 지정된 국가/지역으로 제한됩니다. |
|
extended
|
query |
확장 우편 번호가 결과에 포함되어야 하는 인덱스입니다. 사용 가능한 인덱스는 다음과 같습니다. 추가기 = 주소 범위 지역 = 지리 PAD = 지점 주소 POI = 관심 지점 Str = Streets XStr = 교차로(교차로) 값은 인덱스 형식의 쉼표로 구분된 목록(순서에 관계없이)이거나 인덱스가 없는 경우 None 합니다. 기본적으로 확장 우편 번호는 Geo를 제외한 모든 인덱스에 포함됩니다. 지리에 대한 확장 우편 번호 목록은 매우 길 수 있으므로 필요할 때 명시적으로 요청해야 합니다. 사용 예시: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None 확장 우편 번호는 주소의 extendedPostalCode 속성으로 반환됩니다. 가용성은 지역에 따라 다릅니다. |
||
language
|
query |
string |
검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다. 자세한 내용은 지원되는 언어 참조하세요. |
|
limit
|
query |
integer minimum: 1maximum: 100 |
반환될 최대 응답 수입니다. 기본값: 10, 최소: 1 및 최대: 100 |
|
ofs
|
query |
integer minimum: 0maximum: 1900 |
전체 결과 집합 내에서 반환된 결과의 시작 오프셋입니다. 기본값: 0 |
|
radius
|
query |
integer |
결과가 정의된 영역으로 제한될 반경(미터)이며 최소값은 1이고 최대값은 50000입니다. |
|
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 for any points of interest (POI) within 5 miles of Manhattan NY and return the top 10 results
샘플 요청
GET https://atlas.microsoft.com/search/nearby/json?api-version=1.0&lat=40.70627&lon=-74.011454&limit=10&radius=8046
샘플 응답
{
"summary": {
"queryType": "NEARBY",
"queryTime": 137,
"numResults": 10,
"offset": 0,
"totalResults": 256620,
"fuzzyLevel": 1,
"geoBias": {
"lat": 40.70627,
"lon": -74.011454
}
},
"results": [
{
"type": "POI",
"id": "US/POI/p1/7652731",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002225435-US",
"poi": {
"name": "Ycd Multimedia",
"phone": "+(1)-(212)-5091049",
"categorySet": [
{
"id": 9152
}
],
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652732",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369001882610-US",
"poi": {
"name": "Grubb & Ellis Management Services",
"phone": "+(1)-(212)-7851619",
"categorySet": [
{
"id": 9352039
}
],
"classifications": [
{
"code": "COMPANY",
"names": [
{
"nameLocale": "en-US",
"name": "company"
},
{
"nameLocale": "en-US",
"name": "services"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652735",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369001322824-US",
"poi": {
"name": "Hispanic Federation",
"phone": "+(1)-(212)-7420480",
"categorySet": [
{
"id": 9910004
}
],
"url": "Hispanicfederation.org",
"classifications": [
{
"code": "AUTOMOTIVE_DEALER",
"names": [
{
"nameLocale": "en-US",
"name": "boat"
},
{
"nameLocale": "en-US",
"name": "automotive dealer"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652736",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369000631230-US",
"poi": {
"name": "Edwin Gould Foundation",
"phone": "+(1)-(212)-9825200",
"categorySet": [
{
"id": 9152
}
],
"url": "edwingouldfoundation.org",
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652737",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369001196585-US",
"poi": {
"name": "Newmark Grubb Knight Frank",
"phone": "+(1)-(646)-6951990",
"categorySet": [
{
"id": 9361015
}
],
"url": "www.newmarkkf.com",
"classifications": [
{
"code": "SHOP",
"names": [
{
"nameLocale": "en-US",
"name": "shop"
},
{
"nameLocale": "en-US",
"name": "real estate agents"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652738",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002164164-US",
"poi": {
"name": "Sponsors For Educational Opportunity",
"phone": "+(1)-(212)-7851361",
"categorySet": [
{
"id": 9152
}
],
"url": "www.seo-usa.org",
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373205",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840361001736646-US",
"poi": {
"name": "Visiting Nurse Service",
"phone": "+(1)-(212)-7428259",
"categorySet": [
{
"id": 9663
}
],
"url": "www.vnsny.org",
"classifications": [
{
"code": "HEALTH_CARE_SERVICE",
"names": [
{
"nameLocale": "en-US",
"name": "health care service"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373206",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840361001326915-US",
"poi": {
"name": "Hispanic In Philanthropy",
"phone": "+(1)-(646)-2777101",
"categorySet": [
{
"id": 9152
}
],
"url": "www.hiponline.org",
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373207",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002316633-US",
"poi": {
"name": "Advantage Technical Resourcing",
"phone": "+(1)-(212)-2691140",
"categorySet": [
{
"id": 9352039
}
],
"classifications": [
{
"code": "COMPANY",
"names": [
{
"nameLocale": "en-US",
"name": "company"
},
{
"nameLocale": "en-US",
"name": "services"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373208",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002031974-US",
"poi": {
"name": "Workshop In Bus Opportunities",
"phone": "+(1)-(212)-6840854",
"categorySet": [
{
"id": 9352039
}
],
"url": "www.wibo.org",
"classifications": [
{
"code": "COMPANY",
"names": [
{
"nameLocale": "en-US",
"name": "company"
},
{
"nameLocale": "en-US",
"name": "services"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
}
]
}
정의
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 |
날짜 및 시간을 나타냅니다. |
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일 동안의 시간 범위 목록 |
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 |
찾은 총 결과 수입니다. |