ブロックリファレンス

BLOCKS Reference

Google Maps

標高を取得【アルファ版】

このブロックはアルファ版です。利用にあたっては利用申請が必要です。提供している機能は完全でない場合があり、下位互換性のない変更を加える可能性もあります。このため、テスト環境での使用に適しています。利用申請/機能改善の要望/不具合の報告などは、MAGELLAN BLOCKS のお問い合わせ機能からお願いします。

概要

このブロックは、Google Maps Platform の Elevation API を使って、1 か所または複数場所の標高を取得します。

標高を取得ブロックの概念図

(画像をクリックすると拡大表示されます。)

標高は、海底の深さ(負の値)を含め、地表のすべての場所で利用可能です。指定された場所の正確な標高測定値を Google Maps Elevation サービスで保持していない場合、指定された場所に最も近い 4 地点の正確な標高測定値からの平均値で補間した値を返します。標高は、局所平均海面(LMSL)を基準として表されます。

セルフサービスプランの場合は、利用する GCP プロジェクトにおいて、Elevation API を有効化する必要があります。

このブロックは、Google Maps Platform の Elevation API を利用しているため、その利用量に応じた料金が別途発生します(従量課金制)。料金について詳しくは、Elevation API  |  Google Developers を参照願います。

MAGELLAN BLOCKS では、利用する機能に合わせて、さまざまな API を利用しています。これらについても利用量に応じた料金が発生します。

  • データ保存先(Google Cloud Storage や BigQuery など)の操作:Google Cloud Platform の API
  • 機械学習の各機能:AI Platform の API

プロパティ

プロパティ名 説明
ブロック名

編集パネルに配置した当該ブロックの表示名が変更できます。

ブロックリストパネル中のブロック名は変更されません。

GCP API キー

このブロックで利用する Google Maps Platform API に必要な GCP の API キーを指定します。

GCP API キーは、次の手順で作成します。

  1. Google Cloud Platform コンソール へ移動します。
  2. プロジェクトを選択します。
  3. 画面上部にある[認証情報を作成]ボタンをクリックします。
  4. API キーを選択します。
経緯度が格納された変数

標高を取得したい経緯度が格納された変数を指定します。

変数値は、オブジェクトもしくはオブジェクトの配列で準備します。オブジェクトの形式は、以下の通りです。

{
  "location": 経緯度
}
キー
location 文字列

緯度・経度の順で、カンマ区切りで指定します(例:"35.710063,139.8107")。

以下は、オブジェクトをオブジェクト生成ブロックで指定した例です。

オブジェクトをオブジェクト生成ブロックで指定する例

(画像をクリックすると拡大表示されます。)

このケースの場合は、このプロパティに _ を指定します。

オブジェクトの配列の場合は、以下のように指定します。

オブジェクトの配列をオブジェクト生成ブロックで指定する例

(画像をクリックすると拡大表示されます。)

このケースの場合は、このプロパティに _.locations を指定します。

結果を格納する変数

取得した標高が格納される変数を指定します。

この変数には、以下に示すキーを含んだオブジェクトの配列が格納されます。

キー 説明
location

経緯度が格納された変数」プロパティで指定された location(経緯度)の値です。

elevation

location の標高です(単位:メートル)。

指定された location の正確な標高測定値を Google Maps Elevation サービスで保持していない場合、指定された location に最も近い 4 地点の正確な標高測定値からの平均値で補間した値を返します。

標高は、局所平均海面(LMSL)を基準として表されます。

resolution

elevation が正確な標高測定値ではない場合(補完された標高のとき)のみ出力され、指定された location に最も近い 4 地点の正確な標高測定値との最大距離を表します(単位:メートル)。

経緯度が複数指定された場合は、指定された順序で各標高情報が格納されます。

以下は、格納されたオブジェクトの配列の例です。

[
  {
    "location": "35.710063,139.8107",
    "elevation": 2.678915500640869,
    "resolution": 9.543951988220215
  },
  {
    "location": "48.85837009999999,2.2944813",
    "elevation": 34.49020767211914,
    "resolution": 9.543951988220215
  }
]
ブロックメモ このブロックに関するメモが記載できます。このブロックの処理に影響しません。

この情報は役に立ちましたか?