Elevation

ElevationService クラス

google.maps.ElevationService クラス

Google サーバーと直接通信して高度データをリクエストするサービス クラスを定義します。

アクセスするには、const {ElevationService} = await google.maps.importLibrary("elevation") を呼び出します。詳しくは、Maps JavaScript API のライブラリをご覧ください。

ElevationService
ElevationService()
パラメータ: なし
Google サーバーに高度クエリを送信する ElevationService の新しいインスタンスを作成します。
getElevationAlongPath
getElevationAlongPath(request[, callback])
パラメータ: 
パスに沿った高度リクエストを作成します。高度データはこのパスに沿った距離ベースのサンプルとして返されます。
getElevationForLocations
getElevationForLocations(request[, callback])
パラメータ: 
離れた地点のリストに対する高度リクエストを作成します。

LocationElevationRequest インターフェース

google.maps.LocationElevationRequest インターフェース

ElevationService から送信された高度リクエスト。高度データを返す個別の座標(LatLng)のリストが含まれます。

locations optional
タイプ:  Array<LatLng|LatLngLiteral> optional
高度を取得する対象の、分散した地点。

LocationElevationResponse インターフェース

google.maps.LocationElevationResponse インターフェース

LocationElevationRequest の場所に一致する ElevationResult のリストを含む ElevationService から返される高度レスポンス。

results
タイプ:  Array<ElevationResult>
LocationElevationRequest のロケーションと一致する ElevationResult のリスト。

PathElevationRequest インターフェース

google.maps.PathElevationRequest インターフェース

サンプリングされたデータを返すパスを含む ElevationService から送信された高度クエリ。このリクエストでは、高度サンプルを等間隔に配置した、地球に沿った連続した経路を定義します。すべてのパスは頂点から頂点まで、これらの 2 点間の大圏のセグメントを使用します。

samples
タイプ:  number
必須。エンドポイントを含む高度データを取得する、指定されたパスに沿った等距離点の数。サンプル数は 2 ~ 512 の範囲で指定する必要があります。
path optional
タイプ:  Array<LatLng|LatLngLiteral> optional
高度の値を収集するパス。

PathElevationResponse インターフェース

google.maps.PathElevationResponse インターフェース

PathElevationRequest のパスに沿って等間隔に配置された ElevationResult のリストを含む ElevationService から返される高度レスポンス。

results
タイプ:  Array<ElevationResult>
PathElevationRequest のサンプルと一致する ElevationResult のリスト。

ElevationResult インターフェース

google.maps.ElevationResult インターフェース

ElevationService リクエストの結果。高度座標のセットと高度値で構成されます。1 つのリクエストで複数の ElevationResult が生成されることがあります。

elevation
タイプ:  number
この地点の海抜(メートル単位)。
resolution
タイプ:  number
高度が補間されたサンプル ポイント間の距離(メートル単位)。解像度が不明の場合は、このプロパティは存在しません。なお、複数の地点が渡された場合は、高度データがより粗く(resolution の値が大きくなる)なります。各地点の最も正確な標高値を取得するには、個別に問い合わせをする必要があります。
location optional
タイプ:  LatLng optional
この高度の結果の場所。

ElevationStatus 定数

google.maps.ElevationStatus 定数

高度リクエストの完了時に ElevationService から返されるステータス。値または定数名を使用して指定します。たとえば、'OK'google.maps.ElevationStatus.OK などです。

アクセスするには、const {ElevationStatus} = await google.maps.importLibrary("elevation") を呼び出します。詳しくは、Maps JavaScript API のライブラリをご覧ください。

INVALID_REQUEST リクエストは無効です。
OK リクエストに対してエラーが返されませんでした。
OVER_QUERY_LIMIT ウェブページは、短期間にリクエストの制限回数を超えました。
REQUEST_DENIED ウェブページで高度サービスを使用することはできません。
UNKNOWN_ERROR 高度リクエストを処理できませんでした。失敗の正確な理由は不明です。