このページは Cloud Translation API によって翻訳されました。

ルーティングの概要を計算する

テキスト検索（新版）または周辺検索（新版）を使用して、レスポンス内の各場所までの移動時間と距離を計算するには:

リクエストで routingParameters.origin パラメータを渡して、ルートの出発地の緯度と経度の座標を指定します。このパラメータは、レスポンス内の各地点までの所要時間と距離を計算するために必要です。
レスポンスに routingSummaries 配列が含まれるように、フィールドマスクに routingSummaries を含めます。この配列には、ルーティングの出発地からレスポンス内の各場所までの所要時間と距離が含まれます。

注: routingParameters.origin パラメータまたは searchAlongRouteParameters.polyline.encodedPolyline パラメータのいずれかをリクエストに含めずに、フィールドマスクに routingSummaries を追加すると、エラーが発生します。

API Explorer を使用すると、ライブリクエストを行って、API と API オプションを理解できます。

テキスト検索（新版）を使用する

次のリクエストでは、テキスト検索（新版）のレスポンスに含まれる各場所までの移動時間と距離を計算します。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

レスポンスには 2 つの JSON 配列が含まれます。places 配列には一致する場所が格納され、routingSummaries 配列には各場所までの移動時間と距離が格納されます。

{
  "places": [
    {
      object (Place)
    }
  ]
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
}

routingSummaries 配列の各要素は、places 配列内の場所と同じ配列の場所にあります。つまり、routingSummaries[0] の要素は places[0] の場所に相当します。

routingSummaries の配列の長さは、places の配列の長さと同じです。場所の routingSummary が利用できない場合、配列エントリは空になります。

この例では、ルーティングの出発地から各場所までの所要時間と距離を計算するため、レスポンスの routingSummaries.legs フィールドには、ルーティングの出発地から場所までの duration と distanceMeters を含む 1 つの Leg オブジェクトが含まれます。

注: このレスポンスには、各場所のルート概要にプレビュー版（pre-GA）の directionsUri フィールドも含まれます。このフィールドには、Google マップで場所までのルートを開くためのリンクが含まれます。routingParameters.origin パラメータはルートの出発地として使用され、場所の位置情報は目的地として使用されます。移動手段はデフォルトで自動車になります。

{
  "places": [
    {
      "formattedAddress": "1, Westfield Sydney Central Plaza, 450 George St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Gözleme King Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    …
  ]
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "597s",
          "distanceMeters": 2607
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3fa97cd745:0x6aecf365bf497c08!3e0"
    },
    {
      "legs": [
        {
          "duration": "562s",
          "distanceMeters": 2345
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3da97f60c1:0x845f3273bd764f6c!3e0"
    },
   …
  ]
}

この例から、ルーティングの出発地から結果の最初の場所までの所要時間と距離が 597 秒と 2, 607 メートルであることがわかります。

Nearby Search を使用する

この例では、Nearby Search レスポンス内の各場所までの移動時間と距離を計算します。この例では、オーストラリアのシドニーのレストランを検索し、位置制限とルートの出発地を同じ緯度と経度の座標に設定します。

  curl -X POST -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": -33.8688,
          "longitude": 151.1957362},
        "radius": 500.0
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": -33.8688,
        "longitude": 151.1957362
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key:API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,routingSummaries" \
  https://places.googleapis.com/v1/places:searchNearby

locationRestriction とルーティングの出発地で同じ座標を使用する必要はありません。たとえば、locationRestriction をシドニーの中心点に設定して、検索結果をその円に偏らせます。しかし、その後、ルートの出発地を家の座標、つまり検索円内の別の場所に設定します。リクエストは、検索結果を円にバイアスし、家の位置に基づいてルートの概要を計算します。

移動手段を指定する

デフォルトでは、所要時間と距離の計算は車を対象としています。ただし、検索では車両タイプやその他のオプションを制御できます。

routingParameters.travelMode パラメータを使用して、交通手段のモードを DRIVE、BICYCLE、WALK、または TWO_WHEELER に設定します。これらのオプションの詳細については、ルートで利用可能な車両タイプをご覧ください。

注: Routes API は TRANSIT モードもサポートしていますが、このモードは Places API ではサポートされていません。
注: TWO_WHEELER オプションは、二輪車がサポートされている国と地域に記載されている国でのみサポートされています。
routingParameters.routingPreference プロパティを使用して、ルーティング設定オプションを TRAFFIC_UNAWARE（デフォルト）、TRAFFIC_AWARE、TRAFFIC_AWARE_OPTIMAL のいずれかに設定します。各オプションには、さまざまなレベルのデータ品質とレイテンシがあります。詳細については、交通データを含める方法と含めるかどうかを指定するをご覧ください。
routingParameters.routingPreference プロパティは、プレビュー（Pre-GA）の directionsUri フィールドに含まれる経路に影響します。これは、リンクを開いたときに Google マップで交通状況のオプションが表示されるためです。
routingParameters.routeModifiers プロパティを使用して、avoidTolls、avoidHighways、avoidFerries、avoidIndoor を指定します。これらのオプションの詳細については、回避するルートの特徴を指定するをご覧ください。

次の例では、移動手段を DRIVE に指定し、高速道路を避けるように指定しています。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidHighways": true
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

試してみよう:

API Explorer を使用すると、サンプルリクエストを作成して、API と API オプションを理解できます。

ページの右側にある API アイコン api を選択します。
必要に応じてリクエストパラメータを編集します。
[Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。
API Explorer パネルで、全画面アイコン fullscreen を選択して API Explorer ウィンドウを拡大します。

経路沿いを検索

ルーティングの概要とルート沿いを検索する機能を組み合わせる