Method: computeRoutes

출발지, 목적지, 중간 경유지가 주어지면 기본 경로와 선택적 대체 경로를 반환합니다.

참고: 이 메서드를 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다(사용 가능한 URL 매개변수 및 헤더 참조). 값은 쉼표로 구분된 필드 경로 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.

예를 들어 다음 메서드에서

  • 사용 가능한 모든 필드의 필드 마스크(직접 검사): X-Goog-FieldMask: *
  • 경로 수준 소요 시간, 거리, 다중선의 필드 마스크(프로덕션 설정 예시): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google은 다음과 같은 이유로 와일드 카드(*) 응답 필드 마스크를 사용하거나 최상위 수준(routes)에서 필드 마스크를 지정하지 않는 것이 좋습니다.

  • 필요한 필드만 선택하면 서버에서 계산 주기를 절약할 수 있으므로 지연 시간이 짧은 결과를 반환할 수 있습니다.
  • 프로덕션 작업에 필요한 필드만 선택하면 지연 시간 성능이 안정적으로 유지됩니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가하는 모든 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
  • 필요한 필드만 선택하면 응답 크기가 작아지므로 네트워크 처리량이 높아집니다.

HTTP 요청

POST https://routes.googleapis.com/directions/v2:computeRoutes

URL은 gRPC 트랜스코딩 문법을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
필드
origin

object (Waypoint)

필수 항목입니다. 출발지 경유지입니다.

destination

object (Waypoint)

필수 항목입니다. 목적지 경유지입니다.

intermediates[]

object (Waypoint)

선택사항입니다. 경로를 따라 정차하거나 지나가는 경유지 집합(종점 제외)입니다. 중간 경유지는 최대 25개까지 지원됩니다.

travelMode

enum (RouteTravelMode)

선택사항입니다. 이동 수단을 지정합니다.

routingPreference

enum (RoutingPreference)

선택사항입니다. 경로를 계산하는 방법을 지정합니다. 서버는 선택한 경로 기본 설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 길어지면 오류가 반환됩니다. travelMode가 DRIVE 또는 TWO_WHEELER인 경우에만 이 옵션을 지정할 수 있습니다. 그렇지 않으면 요청이 실패합니다.

polylineQuality

enum (PolylineQuality)

선택사항입니다. 다중선 품질에 대한 환경설정을 지정합니다.

polylineEncoding

enum (PolylineEncoding)

선택사항입니다. 다중선의 기본 인코딩을 지정합니다.

departureTime

string (Timestamp format)

선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 요청을 보낸 시간이 기본값으로 사용됩니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 과거의 departureTime를 지정할 수 있습니다. 대중교통 이동은 과거 최대 7일 또는 미래 최대 100일까지 가능합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

arrivalTime

string (Timestamp format)

선택사항입니다. 도착 시간입니다. 참고: 요청에서 TRANSIT 이외의 RouteTravelMode를 지정하면 이 필드는 무시됩니다. departureTime 또는 arrivalTime 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다. 대중교통 이동은 과거 최대 7일 또는 미래 최대 100일까지 가능합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

computeAlternativeRoutes

boolean

선택사항입니다. 경로 외에 대체 경로를 계산할지 여부를 지정합니다. 중간 경유지가 있는 요청에는 대체 경로가 반환되지 않습니다.

routeModifiers

object (RouteModifiers)

선택사항입니다. 경로 계산 방식에 영향을 미치는 충족해야 하는 조건 집합입니다.

languageCode

string

선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 ID를 참고하세요. 지원되는 언어 목록은 언어 지원을 참조하세요. 이 값을 제공하지 않으면 경로 요청 위치에서 표시 언어가 추론됩니다.

regionCode

string

선택사항입니다. ccTLD('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요.

units

enum (Units)

선택사항입니다. 표시 필드의 측정 단위를 지정합니다. 이러한 필드에는 NavigationInstruction의 instruction 필드가 포함됩니다. 경로, 구간, 단계 거리, 소요 시간에 사용되는 측정 단위는 이 값의 영향을 받지 않습니다. 이 값을 제공하지 않으면 첫 번째 출발지의 위치에서 표시 단위가 추론됩니다.

optimizeWaypointOrder

boolean

선택사항입니다. true로 설정하면 서비스는 지정된 중간 경유지의 순서를 변경하여 경로의 전체 비용을 최소화하려고 시도합니다. 중간 경유지가 via 경유지인 경우 요청이 실패합니다. ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index를 사용하여 새 순서를 찾습니다. X-Goog-FieldMask 헤더에서 ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index가 요청되지 않으면 요청이 실패합니다. optimizeWaypointOrder가 false로 설정되면 ComputeRoutesResponse.optimized_intermediate_waypoint_index가 비어 있습니다.

requestedReferenceRoutes[]

enum (ReferenceRoute)

선택사항입니다. 기본 경로 외에 요청의 일부로 계산할 참조 경로를 지정합니다. 참조 경로는 기본 경로와 다른 경로 계산 목표를 가진 경로입니다. 예를 들어 FUEL_EFFICIENT 참조 경로 계산에서는 최적의 연비 최적 경로를 생성하는 다양한 매개변수를 고려합니다. 이 기능을 사용할 때는 결과 경로에서 routeLabels를 찾으세요.

extraComputations[]

enum (ExtraComputation)

선택사항입니다. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산은 응답에 추가 필드를 반환할 수 있습니다. 이러한 추가 필드는 응답에서 반환되도록 필드 마스크에도 지정해야 합니다.

trafficModel

enum (TrafficModel)

선택사항입니다. 이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 Route 및 RouteLeg의 지속 시간 필드에 반환되는 값에 영향을 미칩니다. 이 필드에는 이전 평균을 기반으로 한 예상 교통량 이동 시간이 포함됩니다. TrafficModel는 RoutingPreference를 TRAFFIC_AWARE_OPTIMAL로, RouteTravelMode를 DRIVE로 설정한 요청에만 사용할 수 있습니다. 교통정보가 요청되고 TrafficModel가 지정되지 않은 경우 기본값은 BEST_GUESS입니다.

transitPreferences

object (TransitPreferences)

선택사항입니다. TRANSIT 경로에 대해 반환되는 경로에 영향을 미치는 환경설정을 지정합니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 transitPreferences를 지정할 수 있습니다.

응답 본문

v2.computeRoutes 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
필드
routes[]

object (Route)

compute_alternatives_routes를 지정하면 계산된 경로의 배열(최대 3개)이 포함되고, 지정하지 않으면 경로가 하나만 포함됩니다. 이 배열에 여러 항목이 포함된 경우 첫 번째 항목이 가장 추천되는 경로입니다. 배열이 비어 있으면 경로를 찾을 수 없음을 의미합니다.

fallbackInfo

object (FallbackInfo)

서버가 모든 입력 환경설정으로 경로 결과를 계산할 수 없는 경우 다른 계산 방법을 사용하도록 대체될 수 있습니다. 대체 모드가 사용되는 경우 이 필드에는 대체 응답에 대한 자세한 정보가 포함됩니다. 그렇지 않으면 이 필드가 설정되지 않습니다.

geocodingResults

object (GeocodingResults)

주소로 지정된 경유지의 지오코딩 응답 정보가 포함됩니다.

PolylineQuality

다중선의 품질을 지정하는 값 집합입니다.

열거형
POLYLINE_QUALITY_UNSPECIFIED 다중선 품질 환경설정이 지정되지 않았습니다. 기본값은 OVERVIEW입니다.
HIGH_QUALITY OVERVIEW보다 많은 포인트를 사용하여 구성된 고품질 다중선을 지정합니다. 응답 크기가 증가합니다. 더 높은 정밀도가 필요한 경우 이 값을 사용합니다.
OVERVIEW 소수의 포인트를 사용하여 구성된 개요 다중선을 지정합니다. 경로 개요를 표시할 때 이 값을 사용합니다. 이 옵션을 사용하면 HIGH_QUALITY 옵션을 사용할 때보다 요청 지연 시간이 짧아집니다.

PolylineEncoding

반환할 기본 다중선 유형을 지정합니다.

열거형
POLYLINE_ENCODING_UNSPECIFIED 다중선 유형 환경설정이 지정되지 않았습니다. 기본값은 ENCODED_POLYLINE입니다.
ENCODED_POLYLINE 다중선 인코딩 알고리즘을 사용하여 인코딩된 다중선을 지정합니다.
GEO_JSON_LINESTRING GeoJSON LineString 형식을 사용하여 다중선을 지정합니다.

ReferenceRoute

ComputeRoutesRequest에서 지원되는 참조 경로입니다.

열거형
REFERENCE_ROUTE_UNSPECIFIED 사용되지 않음. 이 값이 포함된 요청은 실패합니다.
FUEL_EFFICIENT 연비 최적 경로
SHORTER_DISTANCE

이동 거리가 더 짧은 경로입니다. 실험용으로 제공되는 기능입니다.

DRIVE 요청의 경우 이 기능은 운전 편의성보다 짧은 거리를 우선시합니다. 예를 들어 고속도로 대신 지방 도로를 선호하거나, 비포장 도로를 이용하거나, 주차장을 가로지르는 등의 경로를 반환할 수 있습니다. 이 기능은 Google 지도에서 불법으로 인식하는 경로를 반환하지 않습니다.

BICYCLE 및 TWO_WHEELER 요청의 경우 이 기능은 requestedReferenceRoutes를 지정하지 않을 때 반환되는 경로와 유사한 경로를 반환합니다.

이 기능은 다른 이동 수단, 중간 경유지, optimizeWaypointOrder와 호환되지 않으며 이러한 요청은 실패합니다. 하지만 모든 routingPreference에서 사용할 수 있습니다.

ExtraComputation

요청을 완료하는 동안 수행할 추가 계산입니다. 향후 값이 추가될 수 있습니다.

열거형
EXTRA_COMPUTATION_UNSPECIFIED 사용되지 않음. 이 값이 포함된 요청은 실패합니다.
TOLLS 경로의 통행료 정보입니다.
FUEL_CONSUMPTION 경로의 예상 연료 소비량입니다.
TRAFFIC_ON_POLYLINE 경로의 트래픽 인식 다중선입니다.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction: 형식 지정된 HTML 텍스트 문자열로 표시됩니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 이 콘텐츠는 표시 전용입니다. 프로그래매틱 방식으로 파싱하지 마세요.
FLYOVER_INFO_ON_POLYLINE 경로의 플라이오버 정보입니다. 이 정보를 반환하려면 routes.polyline_details.flyover_info 필드 마스크를 지정해야 합니다. 이 데이터는 현재 인도의 특정 대도시에서만 채워집니다. 이 기능은 실험용이며 SKU/요금은 변경될 수 있습니다.
NARROW_ROAD_INFO_ON_POLYLINE 경로의 좁은 도로 정보입니다. 이 정보를 반환하려면 routes.polyline_details.narrow_road_info 필드 마스크를 지정해야 합니다. 이 데이터는 현재 인도의 특정 대도시에서만 채워집니다. 이 기능은 실험용이며 SKU/요금은 변경될 수 있습니다.
TUNNEL_INFO_ON_POLYLINE 경로의 터널 정보입니다. 이 정보를 반환하려면 routes.polyline_details.tunnel_info 필드 마스크를 지정해야 합니다.
BRIDGE_INFO_ON_POLYLINE 경로의 다리 정보입니다. 이 정보를 반환하려면 routes.polyline_details.bridge_info 필드 마스크를 지정해야 합니다.
SKYWAY_INFO_ON_POLYLINE 경로의 고가도로 정보입니다. 이 정보를 반환하려면 routes.polyline_details.skyway_info 필드 마스크를 지정해야 합니다.

경로

시작, 종료, 중간 경유지를 연결하는 일련의 연결된 도로 세그먼트로 구성된 경로를 포함합니다.

JSON 표현
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
필드
routeLabels[]

enum (RouteLabel)

다른 경로와 비교할 경로의 특정 속성을 식별하는 데 유용한 Route의 라벨입니다.

legs[]

object (RouteLeg)

경로를 구성하는 구간(경유지 간 경로 세그먼트)의 컬렉션입니다. 각 구간은 via가 아닌 두 Waypoints 간의 이동에 해당합니다. 예를 들어 중간 경유지가 없는 경로에는 구간이 하나만 있습니다. via가 아닌 중간 경유지 1개가 포함된 경로에는 구간이 2개 있습니다. 중간 경유지 via 1개가 포함된 경로에는 구간이 1개 있습니다. 구간의 순서는 origin에서 intermediates, destination까지의 경유지 순서와 일치합니다.

distanceMeters

integer

경로의 이동 거리(미터)입니다.

duration

string (Duration format)

경로를 탐색하는 데 필요한 시간입니다. routingPreference를 TRAFFIC_UNAWARE로 설정하면 이 값은 staticDuration와 동일합니다. routingPreference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정하면 교통 상황을 고려하여 이 값이 계산됩니다.

routingPreference가 TRAFFIC_AWARE_OPTIMAL로 설정된 경우 승용차 속도 또는 트럭 속도(더 긴 시간)를 사용하여 시간이 계산됩니다. 다음 조건 중 하나에 해당하는 경우 트럭 속도가 사용됩니다.

다른 모든 경우에는 vehicleInfo에 다른 차량 크기나 중량이 지정되어 있더라도 승용차 속도가 사용됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

staticDuration

string (Duration format)

교통 상황을 고려하지 않고 경로를 이동하는 데 걸리는 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

polyline

object (Polyline)

전체 경로 다중선입니다. 이 다중선은 모든 legs의 결합된 다중선입니다.

description

string

경로에 대한 설명입니다.

warnings[]

string

경로를 표시할 때 표시할 경고의 배열입니다.

viewport

object (Viewport)

다중선의 표시 영역 경계 상자입니다.

travelAdvisory

object (RouteTravelAdvisory)

경로에 대한 추가 정보입니다.

optimizedIntermediateWaypointIndex[]

integer

optimizeWaypointOrder를 true로 설정하면 이 필드에는 중간 경유지의 최적화된 순서가 포함됩니다. 그렇지 않으면 이 필드는 비어 있습니다. 예를 들어 출발지: LA, 중간 경유지: 댈러스, 뱅거, 피닉스, 목적지: 뉴욕을 입력하고 최적화된 중간 경유지 순서가 피닉스, 댈러스, 뱅거인 경우 이 필드에는 값 [2, 0, 1]이 포함됩니다. 색인은 입력에 제공된 첫 번째 중간 경유지의 경우 0으로 시작합니다.

localizedValues

object (RouteLocalizedValues)

Route 속성의 텍스트 표현입니다.

routeToken

string

내비게이션 중에 경로를 재구성하고 경로 변경 시 경로가 생성되었을 때의 원래 의도를 반영하기 위해 Navigation SDK에 전달할 수 있는 불투명 토큰입니다. 이 토큰을 불투명 blob으로 취급합니다. 서비스에서 정확히 동일한 경로를 반환하더라도 값이 변경될 수 있으므로 요청 간에 값을 비교하지 마세요.

Route.route_token는 ComputeRoutesRequest.routing_preference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정한 요청에만 사용할 수 있습니다. Route.route_token는 경유지가 있는 요청에 지원되지 않습니다.

polylineDetails

object (PolylineDetails)

다중선을 따라 세부정보가 포함됩니다.

RouteLabel

다른 경로와 비교할 경로의 특정 속성을 식별하는 데 유용한 Route의 라벨입니다.

열거형
ROUTE_LABEL_UNSPECIFIED 기본값 - 사용되지 않습니다.
DEFAULT_ROUTE 경로 계산에 반환되는 기본 '최적' 경로입니다.
DEFAULT_ROUTE_ALTERNATE 기본 '최적' 경로의 대안입니다. computeAlternativeRoutes가 지정되면 이와 같은 경로가 반환됩니다.
FUEL_EFFICIENT 연비 최적 경로 이 값으로 라벨이 지정된 경로는 연료 소비와 같은 친환경 매개변수에 최적화된 것으로 판단됩니다.
SHORTER_DISTANCE 이동 거리가 더 짧은 경로입니다. 실험용으로 제공되는 기능입니다.

RouteLeg

via 이외의 경유지 간 세그먼트가 포함되어 있습니다.

JSON 표현
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
필드
distanceMeters

integer

경로 구간의 이동 거리(미터)입니다.

duration

string (Duration format)

구간을 탐색하는 데 필요한 시간입니다. routingPreference가 TRAFFIC_UNAWARE로 설정된 경우 이 값은 staticDuration와 동일합니다. routingPreference이 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL인 경우 이 값은 교통 상황을 고려하여 계산됩니다.

routingPreference가 TRAFFIC_AWARE_OPTIMAL로 설정된 경우 승용차 속도 또는 트럭 속도(더 긴 시간)를 사용하여 시간이 계산됩니다. 다음 조건 중 하나에 해당하는 경우 트럭 속도가 사용됩니다.

다른 모든 경우에는 vehicleInfo에 다른 차량 크기나 중량이 지정되어 있더라도 승용차 속도가 사용됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

staticDuration

string (Duration format)

교통 상황을 고려하지 않고 계산된 구간 이동 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

polyline

object (Polyline)

각 step의 다중선을 포함하는 이 구간의 전체 다중선입니다.

startLocation

object (Location)

이 구간의 시작 위치입니다. 이 위치는 제공된 origin와 다를 수 있습니다. 예를 들어 제공된 origin가 도로 근처에 있지 않은 경우 이 지점은 도로 위의 지점입니다.

endLocation

object (Location)

이 구간의 종료 위치입니다. 이 위치는 제공된 destination와 다를 수 있습니다. 예를 들어 제공된 destination가 도로 근처에 있지 않은 경우 이 지점은 도로 위의 지점입니다.

steps[]

object (RouteLegStep)

이 구간 내의 세그먼트를 나타내는 단계의 배열입니다. 각 단계는 하나의 탐색 안내를 나타냅니다.

travelAdvisory

object (RouteLegTravelAdvisory)

경로 구간에서 사용자에게 알려야 하는 추가 정보(예: 가능한 교통 구역 제한)가 포함됩니다.

localizedValues

object (RouteLegLocalizedValues)

RouteLeg 속성의 텍스트 표현입니다.

stepsOverview

object (StepsOverview)

이 RouteLeg의 단계에 관한 개요 정보입니다. 이 필드는 대중교통 경로에만 채워집니다.

폴리라인

인코딩된 다중선을 캡슐화합니다.

JSON 표현
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
필드
다중선 유형을 캡슐화합니다. 기본값은 encoded_polyline입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
encodedPolyline

string

다중선 인코딩 알고리즘을 사용한 다중선의 문자열 인코딩

geoJsonLinestring

object (Struct format)

GeoJSON LineString 형식을 사용하여 다중선을 지정합니다.

상호 배타적 필드의 끝입니다.

RouteLegStep

RouteLeg의 세그먼트를 포함합니다. 단계는 단일 내비게이션 안내에 해당합니다. 경로 구간은 단계로 구성됩니다.

JSON 표현
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
필드
distanceMeters

integer

이 단계의 이동 거리(미터)입니다. 경우에 따라 이 필드에 값이 없을 수도 있습니다.

staticDuration

string (Duration format)

교통 상황을 고려하지 않고 이 단계를 통과하는 데 걸리는 시간입니다. 경우에 따라 이 필드에 값이 없을 수도 있습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

polyline

object (Polyline)

이 단계와 연결된 다중선입니다.

startLocation

object (Location)

이 단계의 시작 위치입니다.

endLocation

object (Location)

이 단계의 종료 위치입니다.

navigationInstruction

object (NavigationInstruction)

탐색 안내

travelAdvisory

object (RouteLegStepTravelAdvisory)

구간 단계에서 사용자에게 알려야 하는 추가 정보(예: 가능한 교통 구역 제한)가 포함됩니다.

localizedValues

object (RouteLegStepLocalizedValues)

RouteLegStep 속성의 텍스트 표현입니다.

transitDetails

object (RouteLegStepTransitDetails)

이동 수단이 TRANSIT인 경우 이 단계와 관련된 세부정보입니다.

travelMode

enum (RouteTravelMode)

이 단계에 사용된 이동 수단입니다.

Maneuver

현재 단계에서 취할 내비게이션 작업(예: 좌회전, 합류, 직진)을 지정하는 값 집합입니다.

열거형
MANEUVER_UNSPECIFIED 사용되지 않음.
TURN_SLIGHT_LEFT 왼쪽으로 살짝 돌리세요.
TURN_SHARP_LEFT 왼쪽으로 급회전합니다.
UTURN_LEFT 왼쪽으로 유턴하세요.
TURN_LEFT 왼쪽으로 이동하세요.
TURN_SLIGHT_RIGHT 오른쪽으로 살짝 돌리세요.
TURN_SHARP_RIGHT 오른쪽으로 급회전합니다.
UTURN_RIGHT 오른쪽으로 유턴하세요.
TURN_RIGHT 오른쪽으로 이동하세요.
STRAIGHT 직진하세요.
RAMP_LEFT 왼쪽 램프에 진입하세요.
RAMP_RIGHT 우측 진입로로 진입하세요.
MERGE 차량 흐름에 합류합니다.
FORK_LEFT 왼쪽 갈림길로 가세요.
FORK_RIGHT 오른쪽 갈림길로 가세요.
FERRY 페리를 타세요.
FERRY_TRAIN 페리로 이어지는 기차를 타세요.
ROUNDABOUT_LEFT 회전교차로에서 좌회전하세요.
ROUNDABOUT_RIGHT 회전교차로에서 우회전하세요.
DEPART 초기 기동
NAME_CHANGE 도로 이름 변경을 나타내는 데 사용됩니다.
DESTINATION 목적지 도착을 나타내는 데 사용됩니다.

RouteLegStepTravelAdvisory

구간 단계에서 발생할 수 있는 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함됩니다.

JSON 표현
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
필드
speedReadingIntervals[]

object (SpeedReadingInterval)

참고: 이 필드는 현재 채워져 있지 않습니다.

RouteLegStepLocalizedValues

특정 속성의 텍스트 표현입니다.

JSON 표현
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
필드
distance

object (LocalizedText)

텍스트 형식으로 표시된 이동 거리입니다.

staticDuration

object (LocalizedText)

교통 상황을 고려하지 않은 소요 시간으로, 텍스트 형식으로 표시됩니다.

RouteLegStepTransitDetails

TRANSIT 경로와 관련된 RouteLegStep에 대한 추가 정보입니다.

JSON 표현
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
필드
stopDetails

object (TransitStopDetails)

단계의 도착 및 출발 정류장에 관한 정보입니다.

localizedValues

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails 속성의 텍스트 표현입니다.

headsign

string

이 노선의 이동 방향을 지정하며 차량이나 출발 정류장에 표시됩니다. 방향은 종착역인 경우가 많습니다.

headway

string (Duration format)

현재 동일한 정류장의 예상 배차 간격을 기간으로 지정합니다. 예를 들어 배차 간격 초 값이 600인 경우 버스를 놓치면 다음 버스까지 10분을 기다려야 합니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

transitLine

object (TransitLine)

이 단계에서 사용되는 대중교통 노선에 대한 정보입니다.

stopCount

integer

출발지에서 도착지까지의 정류장 수입니다. 이 개수에는 도착 정류장은 포함되지만 출발 정류장은 제외됩니다. 예를 들어 정류장 A에서 출발하여 정류장 B와 C를 지나 정류장 D에 도착하는 경로의 경우 stopCount는 3을 반환합니다.

tripShortText

string

승객에게 대중교통 이동을 식별하기 위해 일정 및 표지판에 표시되는 텍스트입니다. 텍스트는 서비스 제공일 중의 경로를 고유하게 식별해야 합니다. 예를 들어 '538'은 평일 15시 10분에 캘리포니아주 산호세에서 캘리포니아주 새크라멘토로 출발하는 암트랙 열차의 tripShortText입니다.

TransitStopDetails

RouteLegStep의 대중교통 정류장에 관한 세부정보입니다.

JSON 표현
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
필드
arrivalStop

object (TransitStop)

단계의 도착 정류장에 관한 정보입니다.

arrivalTime

string (Timestamp format)

단계의 도착 예정 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

departureStop

object (TransitStop)

단계의 출발 정류장에 관한 정보입니다.

departureTime

string (Timestamp format)

단계의 예상 출발 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

TransitStop

대중교통 정류장에 관한 정보입니다.

JSON 표현
{
  "name": string,
  "location": {
    object (Location)
  }
}
필드
name

string

대중교통 정류장의 이름입니다.

location

object (Location)

위도/경도 좌표로 표현된 정류장의 위치입니다.

TransitDetailsLocalizedValues

RouteTransitDetails 값의 현지화된 설명입니다.

JSON 표현
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
필드
arrivalTime

object (LocalizedTime)

해당 시간대가 있는 형식화된 텍스트 표현의 시간입니다.

departureTime

object (LocalizedTime)

해당 시간대가 있는 형식화된 텍스트 표현의 시간입니다.

LocalizedTime

현지화된 시간 설명입니다.

JSON 표현
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
필드
time

object (LocalizedText)

지정된 시간대의 문자열로 지정된 시간입니다.

timeZone

string

시간대가 포함됩니다. IANA 시간대 데이터베이스(예: 미국/뉴욕')에 따라 정의된 시간대의 이름이 값으로 사용됩니다.

TransitLine

이 단계에서 사용되는 대중교통 노선에 대한 정보가 포함됩니다.

JSON 표현
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
필드
agencies[]

object (TransitAgency)

이 대중교통 노선을 운영하는 대중교통 기관입니다.

name

string

이 대중교통 노선의 전체 이름입니다(예: '8 Avenue Local').

uri

string

대중교통 기관에서 제공하는 대중교통 노선의 URI입니다.

color

string

이 노선의 표지판에 흔히 사용되는 색상입니다. 16진수로 표시됩니다.

iconUri

string

이 노선과 연결된 아이콘의 URI입니다.

nameShort

string

이 대중교통 노선의 짧은 이름입니다. 이 이름은 일반적으로 'M7' 또는 '355'와 같은 노선 번호입니다.

textColor

string

이 노선의 표지판에 흔히 사용되는 텍스트의 색상입니다. 16진수로 표시됩니다.

vehicle

object (TransitVehicle)

이 대중교통 노선에서 운행되는 운송 수단의 유형입니다.

TransitAgency

대중교통 노선을 운영하는 대중교통 기관입니다.

JSON 표현
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
필드
name

string

이 대중교통 기관의 이름입니다.

phoneNumber

string

국가 코드 포함 형식의 대중교통 기관 전화번호입니다.

uri

string

대중교통 기관의 URI입니다.

TransitVehicle

대중교통 경로에 사용되는 차량에 관한 정보입니다.

JSON 표현
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
필드
name

object (LocalizedText)

이 차량의 이름입니다(대문자로 표기).

type

enum (TransitVehicleType)

사용된 차량 유형입니다.

iconUri

string

이 운송 수단 유형과 연결된 아이콘의 URI입니다.

localIconUri

string

지역 교통 표지판을 기반으로 이 운송 수단 유형과 연결되는 아이콘의 URI입니다.

TransitVehicleType

대중교통 노선의 이동 수단 유형입니다.

열거형
TRANSIT_VEHICLE_TYPE_UNSPECIFIED 사용하지 않습니다.
BUS 버스
CABLE_CAR 일반적으로 지상에서 케이블로 운영되는 차량입니다. 공중 케이블카는 GONDOLA_LIFT 유형일 수도 있습니다.
COMMUTER_TRAIN 통근 열차
FERRY 페리
FUNICULAR 케이블로 당겨서 가파른 경사를 오르는 차량입니다. 푸니쿨라는 일반적으로 두 차량으로 구성되며, 각 차량이 다른 차량의 평형추 역할을 합니다.
GONDOLA_LIFT 공중 케이블카
HEAVY_RAIL 철도
HIGH_SPEED_TRAIN 고속 열차
INTERCITY_BUS 시외버스
LONG_DISTANCE_TRAIN 장거리 열차
METRO_RAIL 경전철
MONORAIL 모노레일
OTHER 기타 모든 차량
RAIL 철도
SHARE_TAXI 합승 택시는 일종의 버스이며, 경로상의 어느 곳에서나 승객이 승하차할 수 있습니다.
SUBWAY 지하철
TRAM 지상철
TROLLEYBUS 트롤리 버스

RouteLegTravelAdvisory

가능한 교통 구역 제한과 같이 구간 단계에서 사용자에게 알려야 하는 추가 정보가 포함됩니다.

JSON 표현
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
필드
tollInfo

object (TollInfo)

특정 RouteLeg의 통행료에 관한 정보가 포함되어 있습니다. 이 필드는 RouteLeg에 통행료가 있을 것으로 예상되고 TOLLS가 요청의 ComputeRoutesRequest.extra_computations에 포함된 경우에만 채워집니다. 이 필드가 설정되어 있지만 estimatedPrice 하위 필드가 채워지지 않은 경우 도로에 통행료가 포함되어 있지만 예상 가격을 알 수 없습니다. tollInfo가 없으면 RouteLeg에 통행료가 없습니다.

speedReadingIntervals[]

object (SpeedReadingInterval)

교통 밀도를 나타내는 속도 판독 간격입니다. 이 필드는 요청에 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference 값이 있고 TRAFFIC_ON_POLYLINE가 ComputeRoutesRequest.extra_computations에 포함된 경우에만 요청에 채워집니다. 간격은 RouteLeg의 전체 다중선을 겹치지 않게 포함합니다. 지정된 간격의 시작점은 이전 간격의 종료점과 동일합니다.

예:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

특정 속성의 텍스트 표현입니다.

JSON 표현
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
필드
distance

object (LocalizedText)

텍스트 형식으로 표시된 이동 거리입니다.

duration

object (LocalizedText)

텍스트 형식으로 표시되고 쿼리 지역에 맞게 현지화된 기간입니다. 교통 상황을 고려합니다. 참고: 교통정보를 요청하지 않은 경우 이 값은 staticDuration과 동일합니다.

staticDuration

object (LocalizedText)

교통 상황을 고려하지 않은 소요 시간으로, 텍스트 형식으로 표시됩니다.

StepsOverview

RouteLegStep 목록에 대한 개요 정보를 제공합니다.

JSON 표현
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
필드
multiModalSegments[]

object (MultiModalSegment)

RouteLeg.steps의 다양한 멀티모달 세그먼트에 관한 요약 정보입니다. RouteLeg의 단계에 멀티모달 세그먼트가 포함되어 있지 않으면 이 필드가 채워지지 않습니다.

MultiModalSegment

RouteLeg.steps의 다양한 멀티모달 세그먼트에 관한 요약 정보를 제공합니다. 멀티모달 세그먼트는 동일한 RouteTravelMode를 갖는 하나 이상의 연속된 RouteLegStep로 정의됩니다. RouteLeg의 단계에 멀티모달 세그먼트가 포함되어 있지 않으면 이 필드가 채워지지 않습니다.

JSON 표현
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
필드
navigationInstruction

object (NavigationInstruction)

멀티모달 세그먼트의 NavigationInstruction입니다.

travelMode

enum (RouteTravelMode)

멀티모달 세그먼트의 이동 수단입니다.

stepStartIndex

integer

멀티모달 세그먼트의 시작인 해당 RouteLegStep 색인입니다.

stepEndIndex

integer

멀티모달 세그먼트의 끝인 해당 RouteLegStep 색인입니다.

표시 영역

위도-경도 표시 영역으로, 대각선으로 반대되는 두 개의 low 및 high 지점으로 표시됩니다. 뷰포트는 경계를 포함하는 닫힌 영역으로 간주됩니다. 위도 경계는 -90~90도(포함) 사이여야 하며 경도 경계는 -180~180도(포함) 사이여야 합니다. 다양한 케이스는 다음과 같습니다.

  • low = high인 경우 표시 영역은 해당 단일 지점으로 구성됩니다.

  • low.longitude > high.longitude인 경우 경도 범위가 반전됩니다(표시 영역이 경도 180도 선을 가로지름).

  • low.longitude = -180도이고 high.longitude = 180도인 경우 표시 영역에 모든 경도가 포함됩니다.

  • low.longitude = 180도이고 high.longitude = -180도이면 경도 범위가 비어 있습니다.

  • low.latitude > high.latitude인 경우 위도 범위가 비어 있습니다.

low 및 high를 모두 채워야 하며, 표시된 상자는 비워둘 수 없습니다(위 정의에 지정됨). 뷰포트가 비어 있으면 오류가 발생합니다.

예를 들어 다음 표시 영역은 뉴욕시를 완전히 둘러쌉니다.

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 표현
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
필드
low

object (LatLng)

필수 항목입니다. 표시 영역의 최저점입니다.

high

object (LatLng)

필수 항목입니다. 표시 영역의 높은 지점입니다.

RouteLocalizedValues

특정 속성의 텍스트 표현입니다.

JSON 표현
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
필드
distance

object (LocalizedText)

텍스트 형식으로 표시된 이동 거리입니다.

duration

object (LocalizedText)

텍스트 형식으로 표시되고 쿼리 지역에 맞게 현지화된 기간입니다. 교통 상황을 고려합니다. 참고: 교통정보를 요청하지 않은 경우 이 값은 staticDuration와 동일합니다.

staticDuration

object (LocalizedText)

교통 상황을 고려하지 않은 소요 시간으로, 텍스트 형식으로 표시됩니다.

transitFare

object (LocalizedText)

텍스트 형식으로 표시된 대중교통 요금입니다.

PolylineDetails

다중선의 특정 색인 또는 연속 세그먼트에 해당하는 세부정보입니다. P_0, P_1, … , P_N(0 기반 색인) 점이 있는 다중선이 주어지면 PolylineDetails는 간격과 연결된 메타데이터를 정의합니다.

JSON 표현
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
필드
tunnelInfo[]

object (TunnelInfo)

다중선을 따라 터널 세부정보를 표시합니다. 요청에서 avoidTunnels 경로 수정자를 지정하고 결과 경로가 이를 피하지 못하는 경우 또는 extraComputations에 TUNNEL_INFO_ON_POLYLINE가 지정되고 경로에 터널이 포함된 경우 이 필드가 채워집니다.

restrictionInfo[]

object (RestrictionInfo)

다중선을 따라 표시되는 제한사항 세부정보입니다. 이 필드는 요청에서 vehicleInfo 경로 수정자를 지정하고 결과 경로에 관련 제한사항이 포함된 경우에만 채워집니다. 그렇지 않으면 이 필드는 사용되지 않습니다.

flyoverInfo[]

object (FlyoverInfo)

다중선을 따라 표시되는 플라이오버 세부정보입니다.

narrowRoadInfo[]

object (NarrowRoadInfo)

다중선을 따라 좁은 도로 세부정보를 표시합니다.

bridgeInfo[]

object (BridgeInfo)

다중선을 따라 있는 다리 세부정보입니다.

skywayInfo[]

object (SkywayInfo)

다중선을 따라 표시되는 고가도로 세부정보입니다.

TunnelInfo

다중선을 따라 있는 터널에 관한 정보를 캡슐화합니다.

JSON 표현
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
필드
tunnelPresence

enum (RoadFeatureState)

다중선의 특정 구간에 터널이 있는지 여부를 나타냅니다.

polylinePointIndex

object (PolylinePointIndex)

다중선을 따라 터널 관련 정보가 있는 위치입니다.

RoadFeatureState

다중선 구간을 따라 도로 지형지물의 상태를 캡슐화합니다.

열거형
ROAD_FEATURE_STATE_UNSPECIFIED 도로 지형지물의 상태가 계산되지 않았습니다(기본값).
EXISTS 도로 지형지물이 존재합니다.
DOES_NOT_EXIST 도로 지형지물이 존재하지 않습니다.

PolylinePointIndex

다중선 세부정보의 시작 및 끝 색인을 캡슐화합니다. 데이터가 단일 지점에 해당하는 경우 startIndex와 endIndex는 동일합니다.

JSON 표현
{
  "startIndex": integer,
  "endIndex": integer
}
필드
startIndex

integer

다중선에서 이 세부정보의 시작 색인입니다.

endIndex

integer

다중선에서 이 세부정보의 종료 색인입니다.

RestrictionInfo

다중선을 따라 다양한 제한사항에 관한 정보를 캡슐화합니다.

JSON 표현
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
필드
restrictionPresence

enum (RoadFeatureState)

출력 전용입니다. 다중선의 특정 구간에 제한이 있는지 여부를 나타냅니다.

polylinePointIndex

object (PolylinePointIndex)

다중선을 따라 제한 관련 정보가 있는 위치입니다.

다중선의 특정 구간에 적용할 수 있는 제한 유형을 캡슐화합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
restrictedHeightMm

string (int64 format)

높이 제한(밀리미터)입니다. 이 필드는 제한된 높이로 인해 지정된 차량이 통과할 수 없거나 여유 공간이 부족한 경우에 채워집니다.

restrictedWeightKg

string (int64 format)

무게 제한(킬로그램)입니다. 이 필드는 중량 제한으로 인해 통행이 불가능하거나 지정된 차량의 중량에 근접한 경우에 채워집니다.

hazardousGoods

boolean

위험물 운송이 제한되는 경우 이 필드는 true로 설정됩니다.

trucksProhibited

boolean

트럭이 금지된 경우 이 필드는 true로 설정됩니다.

상호 배타적 필드의 끝입니다.

FlyoverInfo

다중선을 따라 이동하는 플라이오버에 관한 정보를 캡슐화합니다.

JSON 표현
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
필드
flyoverPresence

enum (RoadFeatureState)

출력 전용입니다. 다중선의 특정 구간에 고가도로가 있는지 여부를 나타냅니다.

polylinePointIndex

object (PolylinePointIndex)

다중선을 따라 플라이오버 관련 정보가 있는 위치입니다.

NarrowRoadInfo

다중선을 따라 좁은 도로에 관한 정보를 캡슐화합니다.

JSON 표현
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
필드
narrowRoadPresence

enum (RoadFeatureState)

출력 전용입니다. 다중선의 특정 구간에 좁은 도로가 있는지 여부를 나타냅니다.

polylinePointIndex

object (PolylinePointIndex)

다중선을 따라 좁은 도로와 관련된 정보의 위치입니다.

BridgeInfo

다중선을 따라 있는 다리에 관한 정보를 캡슐화합니다.

JSON 표현
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
필드
bridgePresence

enum (RoadFeatureState)

다중선의 특정 구간에 다리가 있는지 여부를 나타냅니다.

polylinePointIndex

object (PolylinePointIndex)

다중선을 따라 브리지 관련 정보가 있는 위치입니다.

SkywayInfo

다중선을 따라 있는 고가 보도에 관한 정보를 캡슐화합니다.

JSON 표현
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
필드
skywayPresence

enum (RoadFeatureState)

다중선의 특정 구간에 고가 보도가 있는지 여부를 나타냅니다.

polylinePointIndex

object (PolylinePointIndex)

다중선을 따라 고가 보도 관련 정보의 위치입니다.

GeocodingResults

출발지, 목적지, 중간 경유지의 GeocodedWaypoints가 포함됩니다. 주소 경유지에만 채워집니다.

JSON 표현
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
필드
origin

object (GeocodedWaypoint)

출발지 지오코딩된 경유지입니다.

destination

object (GeocodedWaypoint)

지오코딩된 목적지 경유지입니다.

intermediates[]

object (GeocodedWaypoint)

지오코딩된 중간 경유지 목록으로, 각 경유지에는 요청에 지정된 순서대로 경유지의 0부터 시작하는 위치에 해당하는 색인 필드가 포함됩니다.

GeocodedWaypoint

경유지로 사용되는 위치에 대한 세부정보입니다. 주소 경유지에만 채워집니다. 주소가 지오코딩된 대상을 확인하기 위한 지오코딩 결과에 관한 세부정보가 포함됩니다.

JSON 표현
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
필드
geocoderStatus

object (Status)

지오코딩 작업 결과 발생한 상태 코드를 나타냅니다.

type[]

string

0개 이상의 유형 태그 형식으로 된 결과 유형입니다. 지원되는 유형: 주소 유형 및 주소 구성요소 유형

partialMatch

boolean

지오코더가 원래 요청에 대해 정확히 일치하는 결과를 반환하지 않았지만 요청된 주소의 일부분과 일치함을 나타냅니다. 원래 요청을 검사하여 맞춤법 오류 및/또는 불완전한 주소를 찾아낼 수 있습니다.

placeId

string

이 결과의 장소 ID입니다.

intermediateWaypointRequestIndex

integer

요청에 있는 해당 중간 경유지의 색인입니다. 해당 경유지가 중간 경유지인 경우에만 채워집니다.