Search - Post Search Along Route
지정된 경로를 따라 POI에 대한 유사 항목 검색을 수행하는 데 사용합니다.
Post Search Along Route
API는 지정된 경로를 따라 POI에 대한 유사 항목 검색을 수행할 수 있는 HTTP POST
요청입니다. 이 검색은 maxDetourTime
제한 측정값을 지정하여 제한됩니다.
경로 지점을 보내려면 요청 본문에 POST
형식으로 표시되는 route
개체가 포함되고 GeoJSON LineString
헤더가 Content-Type
설정되는 application/json
요청을 사용합니다.
route
각 경로 지점은 GeoJSON Position
형식으로 표시됩니다. 즉, 경도 값 뒤에 위도 값이 잇고 고도 값이 무시되는 배열입니다.
route
2개 이상의 경로 지점을 포함해야 합니다.
원래 경로가 변경될 수 있으며, 그 중 일부는 건너뛸 수 있습니다. 찾은 지점을 통과하는 경로가 원래 경로보다 빠르면 응답의 detourTime
값은 음수입니다.
POST https://atlas.microsoft.com/search/alongRoute/{format}?api-version=1.0&query={query}&maxDetourTime={maxDetourTime}
POST https://atlas.microsoft.com/search/alongRoute/{format}?api-version=1.0&query={query}&maxDetourTime={maxDetourTime}&limit={limit}&brandSet={brandSet}&categorySet={categorySet}&connectorSet={connectorSet}&view={view}&openingHours=nextSevenDays
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
format
|
path | True |
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다. |
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호입니다. |
max
|
query | True |
integer maximum: 3600 |
관심 지점의 최대 우회 시간(초)입니다. 최대값은 3600초입니다. |
query
|
query | True |
string |
검색할 POI 이름입니다(예: "자유의 여신상", "스타벅스", "피자"). URL을 올바르게 인코딩해야 합니다. |
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 |
||
limit
|
query |
integer maximum: 20 |
반환될 최대 응답 수입니다. 기본값은 10입니다. 최대값은 20입니다. |
|
opening
|
query |
POI에 대한 작업 시간(관심 지점). 작업 시간의 가용성은 사용 가능한 데이터에 따라 달라집니다. 전달되지 않으면 영업 시간 정보가 반환되지 않습니다. 지원되는 값: nextSevenDays |
||
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 |
---|---|---|
route |
유효한 |
응답
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 burger joints along a route
샘플 요청
POST https://atlas.microsoft.com/search/alongRoute/json?api-version=1.0&query=burger&maxDetourTime=1000&limit=2&openingHours=nextSevenDays
{
"route": {
"type": "LineString",
"coordinates": [
[
-122.143035,
47.653536
],
[
-122.187164,
47.617556
],
[
-122.114981,
47.570599
],
[
-122.132756,
47.654009
]
]
}
}
샘플 응답
{
"summary": {
"query": "burger",
"queryType": "NON_NEAR",
"queryTime": 394,
"numResults": 2,
"offset": 0,
"totalResults": 2,
"fuzzyLevel": 1
},
"results": [
{
"type": "POI",
"id": "US/POI/p0/8596348",
"score": 3.104,
"dist": 1754.9604168059973,
"info": "search:ta:840531000465150-US",
"poi": {
"name": "BURGER KING",
"phone": "+(1)-(425)-7467508",
"brands": [
{
"name": "BURGER KING"
}
],
"categorySet": [
{
"id": 7315015
}
],
"url": "www.burgerking.com",
"classifications": [
{
"code": "RESTAURANT",
"names": [
{
"nameLocale": "en-US",
"name": "restaurant"
},
{
"nameLocale": "en-US",
"name": "fast food"
}
]
}
]
},
"address": {
"streetNumber": "14620",
"streetName": "NE 24th St",
"municipalitySubdivision": "Crossroads, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "14620 NE 24th St, Bellevue, WA 98007",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.63188,
"lon": -122.14462
},
"viewport": {
"topLeftPoint": {
"lat": 47.63278,
"lon": -122.14595
},
"btmRightPoint": {
"lat": 47.63098,
"lon": -122.14329
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.63155,
"lon": -122.14462
}
}
],
"detourTime": -55
},
{
"type": "POI",
"id": "US/POI/p0/8596112",
"score": 3.111,
"dist": 161.17565489389224,
"info": "search:ta:840531000465149-US",
"poi": {
"name": "BURGER KING",
"phone": "+(1)-(425)-4535775",
"brands": [
{
"name": "BURGER KING"
}
],
"categorySet": [
{
"id": 7315015
}
],
"url": "www.burgerking.com",
"classifications": [
{
"code": "RESTAURANT",
"names": [
{
"nameLocale": "en-US",
"name": "restaurant"
},
{
"nameLocale": "en-US",
"name": "fast food"
}
]
}
]
},
"address": {
"streetNumber": "11723",
"streetName": "NE 8th St",
"municipalitySubdivision": "Willburton, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98005",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "11723 NE 8th St, Bellevue, WA 98005",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.61683,
"lon": -122.18338
},
"viewport": {
"topLeftPoint": {
"lat": 47.61773,
"lon": -122.18471
},
"btmRightPoint": {
"lat": 47.61593,
"lon": -122.18205
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.61723,
"lon": -122.1834
}
}
],
"detourTime": 12
}
]
}
정의
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이 요청되어 사용 가능한 경우에만 표시됩니다. |
Geo |
유효한 |
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 |
이 형식은 경로 검색 서비스에 대한 요청 본문을 나타냅니다. |
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 |
우편 번호 / 우편 번호 |
GeoJsonLineString
유효한 GeoJSON LineString
기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] (double) |
|
type |
string:
Line |
|
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 |
SearchAlongRouteRequest
이 형식은 경로 검색 서비스에 대한 요청 본문을 나타냅니다.
Name | 형식 | Description |
---|---|---|
route |
유효한 |
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 |
찾은 총 결과 수입니다. |