ルート マトリックスのロケーションを指定する

ルート マトリックスを計算するには、少なくとも 1 つのルートの出発地と 1 つのルートの 目的地を表す図を作成します

ルートのロケーションを指定する

場所を表すには、ウェイポイント（REST）を作成します。 または Waypoint（gRPC）オブジェクトを作成します 地点の定義では、次のいずれかの方法で場所を指定できます。

• 場所 ID（推奨）
• 緯度と経度の座標
• Address string（「シカゴ、イリノイ州」、「ダーウィン、NT、オーストラリア」）
• Plus Code

リクエスト内のすべての地点の場所を同じ方法で指定できます。 混ぜてもかまいませんたとえば、緯度と経度の座標を使用して、 目的地の地点にプレイス ID を使用します。

効率性と正確性を高めるため、緯度と経度の代わりにプレイス ID を使用してください 住所文字列を指定できますプレイス ID は一意に明示的に指定され、 ジオコーディングの利点（アクセス ポイントや交通変数など）。 他の方法によって生じる可能性のある、次のような状況を避けることができます。 場所を指定:

• 緯度と経度の座標を使用すると、場所は次のようになります。 これらの座標に最も近い道路にスナップされます。 施設への入口、さらには迅速で安全に通行できる道路まで、 誘導します
• 住所文字列は、最初に Routes API によってジオコーディングされて 緯度と経度の座標に変換してからルートを計算できます。 このコンバージョンはパフォーマンスに影響する可能性があります。

場所をプレイス ID として指定する

プレイス ID を使って地点の位置を指定できます。なぜなら、 緯度と経度の座標が道路にスナップされると、 状況によっては、プレイス ID の方が適切な結果が表示されます。

Geocoding API からプレイス ID を取得する。 Places API（Place API を含む） 予測入力など）。プレイス ID について詳しくは、 プレイス ID の概要。

次の例では、placeId プロパティを使用して、両方のプレイス ID を渡しています。 origin と destination:

{
  "origin":{
    "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
  },
  "destination":{
    "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
  },
  ...
}

緯度と経度の座標で場所を指定する

地点内の場所を定義するには、 位置情報（REST）または Location（gRPC）: 緯度と経度の座標。

たとえば、ルート origin と destination の地点を指定します latitude 座標と longitude 座標を使用:

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
...
}

ロケーションを住所文字列として指定する

住所文字列は、文字列で表されるリテラル住所です（例: 「1600 「 Amphitheatre Parkway, Mountain View, CA」など）。ジオコーディングとは 住所の文字列を緯度と経度の座標（ （例: 緯度 37.423021、経度 -122.083739）。

地点の位置として住所の文字列を渡すと、Routes API は、文字列を内部的にジオコーディングして緯度と経度に変換します。 指定します。

たとえば、ルートを計算するには、ルート origin のウェイポイントを指定します。 住所文字列を使用する destination:

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

この例では、Routes API が両方の住所をジオコーディングして、 緯度と経度の座標。

住所の値があいまいな場合、Routes API は検索を呼び出して、 類似した住所と区別できます例: 「1st Street」たとえば 「1st street NE」の完全値または一部値または「1st St SE」を入力します。この Geocoding API によって返された結果とは異なる場合があります。回避 プレイス ID の使用の誤りを検出します。

アドレスのリージョンを設定する

不完全な住所文字列をウェイポイントの位置として渡すと、API は ジオコーディングされた間違った緯度と経度の座標が使用されている可能性があります。たとえば 「Toledo」を指定してリクエストを「マドリッド」をとして 目的地:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE"
}

この例では、「Toledo」は都市とみなされます オハイオ州はスペインではなく米国のオハイオ州ですしたがって、リクエストは 空の配列は、ルートが存在しないことを意味します。

{
  []
}

次の方法で、特定の地域を優先した結果を返すように API を設定できます。 regionCode パラメータも含まれます。このパラメータでは、地域コードを ccTLD（「トップレベル ドメイン」） 使用できます。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、 いくつか注意すべき例外がありますたとえば、英国の ccTLD は「uk」です。 （.co.uk）、ISO 3166-1 コードは「gb」（厳密には、「The グレート ブリテンおよび北アイルランド連合王国」）。

「Toledo」のルート リクエスト「マドリッド」へregionCode を含む パラメータで適切な結果が返されるようにします。これは「Toledo」がは スペインの都市:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE",
  "regionCode": "es"
}

レスポンスには、スペインのトレドから マドリード（スペイン）:

{
  "routes": [
    {
      "distanceMeters": 75330,
      "duration": "4137s",
      ...
    }
  ]
}

Plus Code で場所を指定する

多くの人は正確な住所を持っておらず、難しい場合がある 配送を受け取れないこともありますメールアドレスを知っている人は、 より具体的な場所（裏口や荷物の積載場所など）に ホルダーにセットします。

Plus Codes は、住所がない人や場所の番地のようなものです。 指定します。Plus Codes を使用すると、番地や番地を含む住所の代わりに、 緯度と経度の座標に基づいており、数値と座標の 使用できます。

Google が開発した Plus Codes すべての人にアドレスの利点を 提供したいと考えていますPlus Code は、 緯度と経度の座標から導出される 面積を表す: 1/8000 度から 1/8000 度（約 14m x 14 m 以下）。Plus Codes は、 住所が存在しない、または建物がない場所の番地 通りの名前はありません。

Plus Codes は、グローバル コードまたは複合コードとしてフォーマットする必要があります。

• グローバル コードは、4 文字の市外局番と 6 文字のコードで構成されます。 文字または長いローカルコード。

  たとえば、住所が「1600 Amphitheatre Parkway」の場合、 グローバル コードは「849V」です。ローカルコードは 「CWC8+R9」。次に、10 文字の Plus Code 全体を使用して、 location 値として「849VCWC8+R9」を指定します。

• 複合コード: 6 文字以上 明示的な場所と組み合わせたローカルコード。

  たとえば、「450 Serra」という住所は Mall, Stanford, CA 94305, USA」ローカルコードは「CRHJ+C3」です。化合物の場合 住所に加えて、ローカルコードを国、都道府県、市区町村、郵便番号と組み合わせたもの の部分は「CRHJ+C3 Stanford, CA 94305, USA」の形式で入力してください。

  たとえば、ルート origin のウェイポイントを指定してルートを計算します。 Plus Code を使用した destination:

  {
    "origin":{
      "address": "849VCWC8+R9"
    },
    "destination":{
      "address": "CRHJ+C3 Stanford, CA 94305, USA"
    },
    "travelMode": "DRIVE"
  }

Plus Codes は、次の Google Maps Platform API でサポートされています。 Place Autocomplete Place Details、 Directions API Geocoding API たとえば Geocoding API を使用すると、 緯度と経度の座標で指定された場所 Plus Code です。