경로 응답 검토

Routes API가 경로를 계산할 때 경유지를 가져와서 사용자가 입력으로 제공하는 구성 매개변수를 선택할 수 있습니다 그러면 API가 응답을 반환합니다. 기본 경로 및 하나 이상의 대체 경로가 포함된 경로

응답에는 다음과 같은 필드가 포함됩니다.

응답에 이를 포함하기 위해 이 문서 보기
차량 엔진 유형에 따른 연비 또는 에너지 효율이 가장 우수한 경로입니다. 친환경 경로 구성하기
대체 경로 최대 3개 대체 경로 요청
전체 경로, 경로의 각 구간 및 각 단계에 대한 폴리라인 볼 수 있습니다 경로 다중선 요청
통행료 할인을 고려한 예상 통행료 또는 패스를 사용할 수 없습니다. 통행료 계산
언어 코드 및 측정 단위 (영국식 또는 측정항목). 현지화된 값 요청
탐색 안내 형식을 HTML 텍스트 문자열로 지정하려면 HTML_FORMATTED_NAVIGATION_INSTRUCTIONS를 extraComputations입니다. 추가 계산

입력 옵션의 전체 목록은 사용 가능한 경로 옵션을 참조하세요. 및 요청 본문.

이 응답을 사용하여 고객에게 정보를 제공할 수 있습니다. 필요에 따라 적절한 경로를 선택하는 데 도움이 됩니다.

필드 마스크에 관한 정보

메서드를 호출하여 경로를 계산할 때 필드를 지정해야 합니다. 마스크는 응답에서 반환되기를 원하는 필드를 정의합니다. 없음 반환된 필드의 기본 목록입니다. 이 목록을 생략하면 메서드가 오류가 발생했습니다.

이 문서의 예에서는 전체 응답 객체를 필드 마스크를 고려해야 합니다 프로덕션 환경에서 응답은 필드 마스크에 명시적으로 지정한 필드만 포함합니다.

자세한 내용은 반환할 정보 선택하기를 참고하세요.

저작권 표시 정보

사용자에게 결과를 표시할 때 다음 저작권 고지를 포함해야 합니다.

Powered by Google, ©YEAR Google

예를 들면 다음과 같습니다.

Powered by Google, ©2023 Google

경로, 구간, 걸음 수 정보

Routes API에서 반환한 응답을 보기 전에 경로를 구성하는 구성 요소를 이해해야 합니다.

경로, 구간, 걸음 수.

응답에는 다음 각 경로 구성요소에 대한 정보가 포함될 수 있습니다.

  • 경로: 출발지 경유지에서 다음 지점까지 전체 여정 중간 경유지에서 도착 경유지로 이동하는 것입니다. 경로는 이상의 구간.

  • 구간: 경로의 한 경유지에서 다음 경유지까지의 경로입니다. 있습니다. 각 구간은 하나 이상의 개별 걸음 수로 구성됩니다.

    경로에는 각 경유지에서 다음 경유지까지의 경로에 대한 개별 구간이 포함됩니다. 예를 들어 경로에 하나의 출발지 경유지와 하나의 경유지가 포함된 경우 목적지가 있다면 경로에 단일 구간이 포함됩니다. 각 출발지와 목적지 다음 경로에 추가하는 경유지 중간 경유지라고 부르면 API에서 별도의 구간을 추가합니다.

    API는 통과 중간 경유지에 구간을 추가하지 않습니다. 대상 예: 출발지 경유지, 통과 경로 도착지 경유지에 출발지에서 출발하는 한 구간만 경유지를 통과하는 동안 목적지로 이동하는 것입니다. 자세한 내용은 통과 경유지에 대한 자세한 내용은 통과 경유지 정의

  • 단계: 경로의 구간에 따른 단일 안내입니다. 한 단계가 경로의 원자 단위입니다. 예를 들어 단계에 '기본 설정에서 왼쪽으로 켜 줘'라고 표시할 수 있습니다. Street'').

응답 내용

JSON 객체 에는 다음과 같은 최상위 속성이 포함되어 있음을 나타냅니다.

  • routes: 다음 유형의 요소의 배열 경로. routes 배열에는 API에서 반환한 경로마다 요소 한 개가 포함됩니다. 배열은 최대 다섯 개의 요소를 포함할 수 있습니다. 기본 경로, 최대 3개의 대체 경로 중에서 선택할 수 있습니다.

  • geocodingResults: 다음 유형의 요소의 배열 GeocodingResults. 요청의 모든 위치 (출발지, 목적지 또는 중간) 경유지)로서 주소 문자열 또는 플러스 코드로 지정한 경우 API가 장소 ID 조회를 수행합니다. 이 배열의 각 요소에는 장소 ID를 반환합니다. 요청의 위치는 다음과 같이 지정됩니다. 장소 ID 또는 위도/경도 좌표는 포함되지 않습니다. 장소 ID 또는 위도와 경도를 사용하여 모든 위치를 지정한 경우 좌표의 경우 이 배열은 제공되지 않습니다.

  • fallbackInfo, 유형 FallbackInfo. API가 모든 입력 속성에서 경로를 계산할 수 없는 경우 다른 계산 방법을 사용하는 것으로 대체할 수 있습니다 대체 시 사용되는 경우 이 필드에는 있습니다. 그렇지 않으면 이 필드가 설정되지 않습니다.

응답의 형식은 다음과 같습니다.

{
  // The routes array.
  "routes": [
    {
      object (Route)
    }
  ],
  // The place ID lookup results.
  "geocodingResults": [
    {
      object (GeocodedWaypoint)
    }
  ],
  // The fallback property.
  "fallbackInfo": {
    object (FallbackInfo)
  }
}

경로 배열 해독

응답에는 routes 배열이 포함되며, 여기서 각 배열 요소는 다음 유형입니다. 경로. 각 배열 요소는 출발지에서 목적지까지의 전체 경로를 나타냅니다. 이 API가 항상 기본 경로라고 하는 경로를 하나 이상 반환합니다.

추가 경로를 요청할 수 있습니다. 만약 친환경 경로인 경우 배열에 다음 두 요소를 포함할 수 있습니다. 기본 경로와 친환경 경로일 수 있습니다. 또는 computeAlternativeRoutes를 다음으로 설정 요청에 true를 포함하여 응답에 최대 3개의 대체 경로를 추가합니다.

배열의 각 경로는 routeLabels 배열 속성으로 식별됩니다.

값 설명
DEFAULT_ROUTE 기본 경로를 식별합니다.
FUEL_EFFICIENT 친환경 경로를 식별합니다.
DEFAULT_ROUTE_ALTERNATE 대체 경로를 발급합니다.

legs 배열에는 경로의 각 구간에 대한 정의가 포함됩니다. 나머지 속성(예: distanceMeters, duration, polyline,)에는 경로 전체에 대한 정보입니다.

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "routeLabels": [string],
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  }
  "routeToken": string
}

현재 운전 상황 및 기타 요인으로 인해 기본 경로와 친환경 경로도 동일할 수 있습니다. 이 경우 routeLabels 배열은 DEFAULT_ROUTE 및 FUEL_EFFICIENT 라벨이 모두 포함됩니다.

{
  "routes": [
    {
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ],
     …
    }
  ]
}

legs 배열 이해

응답의 각 route에는 legs 배열이 포함됩니다. 여기서 각 legs 배열은 요소의 유형이 다음과 같음 RouteLeg). 배열의 각 구간은 한 경유지에서 다음 경유지까지의 경로를 정의합니다. 살펴봤습니다 경로에는 항상 하나 이상의 구간이 포함됩니다.

legs 속성에는 steps 배열 나머지 속성(예: distanceMeters, duration)은 및 polyline에는 구간에 관한 정보가 포함됩니다.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}

단계 배열 이해하기

응답의 각 구간에는 steps 배열이 포함됩니다. 여기서 각 steps 배열은 요소의 유형이 다음과 같음 RouteLegStep으로 설정합니다. 단계는 구간에 있는 단일 명령어에 해당합니다. 다리는 항상 최소 한 단계여야 합니다

steps 배열의 각 요소에는 navigationInstruction가 포함됩니다. 속성, 유형 NavigationInstruction, 여기에는 단계 지침이 포함되어 있습니다. 예를 들면 다음과 같습니다.

"navigationInstruction": {
  "maneuver": "TURN_LEFT",
  "instructions": "Turn left toward Frontage Rd"
}

instructions에는 단계에 대한 추가 정보가 포함될 수 있습니다. 예를 들면 다음과 같습니다.

"navigationInstruction": {
  "maneuver": "TURN_SLIGHT_LEFT",
  "instructions": "Slight left (signs for I-90 W/Worcester)nParts of this road may be closed at certain times or days"
}

단계의 나머지 속성은 단계에 대한 정보를 설명합니다. distanceMeters, duration, polyline 형식으로 반환합니다.

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  }
}

단계 안내의 언어 지정

API는 원하는 경우 기본 설정을 관찰하면서 사용자가 읽을 수 있는 스크립트 있습니다. 주소 구성요소는 모두 동일한 언어로 반환됩니다.

  • languageCode 매개변수를 사용합니다. 요청 지원되는 언어 목록에서 경로 언어를 명시적으로 설정 언어를 참고하세요. Google은 지원되는 이 목록은 완전하지 않을 수 있습니다.

  • 지정된 언어로 이름을 사용할 수 없는 경우 API는 가장 근접한 값을 찾습니다.

  • 지정된 언어는 API는 반환과 반환 순서를 선택합니다. 이 지오코더는 다음과 같이 언어에 따라 약어를 다르게 해석합니다. 거리 유형의 약어 또는 한 형식에서 유효할 수 있는 동의어를 다른 언어로는 볼 수 없습니다. 예를 들어 utca와 tér는 헝가리어로 된 길에 있습니다.

GeocodingResults 배열 이해

요청의 모든 위치 (출발지, 목적지 또는 중간) 경유지)가 주소 문자열 또는 플러스 코드로 지정된 경우 API는 해당하는 장소가 있는 가장 관련성 높은 위치를 찾으려고 시도합니다. 있습니다. 이 geocodingResults 드림 배열에 placeID 필드가 포함됨 장소 ID로 위치를 포함하며 위치를 지정하는 type 필드 유형(예: street_address, premise, airport)

geocodingResults 배열에는 3개의 필드가 있습니다.

  • origin: 주소 문자열 또는 플러스 코드로 지정된 경우 출발지의 장소 ID입니다. 그렇지 않으면 이 필드는 응답에서 생략됩니다.

  • destination: 주소 문자열 또는 플러스 코드로 지정된 경우 목적지의 장소 ID입니다. 그렇지 않으면 이 필드가 있습니다.

  • intermediates: 중간 위치의 장소 ID가 포함된 배열 주소 문자열 또는 플러스 코드로 지정된 경유지. 만약 장소 ID 또는 위도를 사용하여 중간 경유지 및 경도 좌표의 경우 응답에서 생략됩니다. 사용 intermediateWaypointRequestIndex 속성을 사용하여 요청의 장소 ID에 해당하는 중간 경유지 확인할 수 있습니다.

를 통해 개인정보처리방침을 정의할 수 있습니다. 
"geocodingResults": {
    "origin": {
        "geocoderStatus": {},
        "type": [
             enum (Type)
        ],
        "placeId": string
    },
    "destination": {
        "geocoderStatus": {},
        "type": [
            enum (Type)
        ],
        "placeId": string
    },
    "intermediates": [
        {
            "geocoderStatus": {},
            "intermediateWaypointRequestIndex": integer,
            "type": [
                enum (Type)
            ],
            "placeId": string
        },
        {
           "geocoderStatus": {},
           "intermediateWaypointRequestIndex": integer,
            "type": [
                enum (Type)
            ],
            "placeId": string
        }
    ]
}

현지화된 응답 값 이해

현지화된 응답 값은 반환된 매개변수 값의 현지화된 텍스트입니다. 현지화된 텍스트는 이동 시간, 거리, 단위 체계 (미터법 또는 야드파운드법)입니다. 요청 사항 현지화된 값을 사용할 수 있으며, 언어 및 언어 또는 단위 체계를 사용하거나 API에서 추론한 값을 사용할 수 있습니다. 자세한 내용은 LocalizedValues

예를 들어 독일어 (de) 및 야드파운드법 언어 코드를 지정하는 경우 distanceMeters의 값이 49889.7이 됩니다. 또한 독일어 및 독일어로 된 거리 측정을 제공하는 현지화된 텍스트도 "31 Meile"입니다.

다음은 현지화된 값에 대해 표시되는 예입니다.

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}
드림

언어나 단위 체계를 지정하지 않으면 API에서 언어를 유추합니다. 단위를 다음과 같이 지정합니다.

  • ComputeRoutes 메서드는 위치와 거리를 추론합니다. 단위(단위: 초)를 정합니다. 따라서 미국에서 라우팅 요청의 경우 API는 en-US 언어와 IMPERIAL 단위를 추론합니다.
  • ComputeRouteMatrix 메서드의 기본값은 'en-US'입니다. 언어 및 METRIC 단위가 포함됩니다.