以上で完了です。

開発を始めるには、デベロッパー ドキュメント をご覧下さい。

Google Maps Roads API をアクティベートする

まず初めに Google Developers Console で次の作業を行います。

  1. プロジェクトを作成または選択する
  2. Google Maps Roads API をアクティベートする
  3. 適切なキーを作成する
続ける

速度制限

注: 速度制限サービスは、Google Maps APIs Premium Plan

アセット トラッキング ライセンスを保有しているユーザーのみ利用可能です。

Google Maps Roads API は、道路上のある区間に掲示されている速度制限を返します。 可変式速度規制が指定された道路上の区間では、その区間のデフォルトの速度制限が返されます。

Google Maps Roads API が返す速度制限データの正確性は保証できません。 提供される速度制限データはリアルタイムではなく、推定値、不正確な値、不完全な値、古い値が使用されている可能性があります。 データが誤っている場合は、Google Map Maker サービスから報告できます。

リクエスト

速度制限のリクエストは、HTTPS で送信し、次の形式である必要があります。

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

パラメータの使用方法

必須パラメータ

  • path または 1 つ以上の placeId

    • path — スナップするパスです。 path パラメータには、緯度と経度のペアのリストを渡します。 緯度と経度の値は、コンマで区切ります。 座標はパイプ文字「|」で区切ります。 次に例を示します。 path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
    • placeId — 道路上の区間のプレイス ID です。 プレイス ID は、snapToRoads および nearestRoads リクエストのレスポンスで返されます。 1 つのリクエストで、最大 100 個の placeId を渡すことができます。
  • key — アプリケーションの API キーです。 アプリケーションは、Google Maps Roads API にリクエストを送信するたびに API キーをリクエストに含め、送信元を明らかにする必要があります。

詳細については、キーの取得をご覧ください。

省略可能なパラメータ

units — 速度制限(時速)を km で返すかマイルで返すかを指定します。 KPH または MPH のどちらかを設定できます。 デフォルト値は KPH です。

速度制限データは、path または複数の placeId を使用してリクエストできますが、リクエスト内の一意な placeId 1 つにつき、1 つのレスポンスしか受信できません。 短い距離の中にたくさんの地点が存在する場合、重複した placeId が存在する可能性があります。

レスポンス

speedLimits のレスポンスには、次の要素が存在する可能性があります。

  • speedLimits — 道路のメタデータの配列です。 各要素は次のフィールドから構成されます。

    • placeId — プレイスの一意の識別子です。 Google Maps Roads API が返す placeId は、すべて道路上の区間に対応するものです。

    • speedLimit — 道路上の区間の速度制限です。

    • unitsKPHMPH のどちらかを返します。
    • snappedPoints — スナップされた地点の配列です。 この配列は、リクエストに path パラメータが含まれている場合のみ存在します。 各地点は次のフィールドから構成されます。

    • locationlatitudelongitude の値を含みます。

    • originalIndex — 元のリクエスト内の対応する値を示す整数です。 リクエスト内のそれぞれの値がレスポンスのスナップされた値にマッピングされます。 originalIndex0 から開始されるため、この値が 4 の地点は path パラメータで渡された 5 番目の緯度と経度がスナップされた値になります。

    • placeId — プレイスの一意の識別子です。 Google Maps Roads API が返す placeId は、すべて道路上の区間に対応するものです。

    placeId を速度制限リクエストに渡すことによって、その道路上の区間における速度制限を求めることができます。

リクエストの例

次のリクエストは、オーストラリアのキャンベラにある道路の短い区間の速度制限を求めるものです。

リクエスト

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

レスポンス

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。