Elevation

ElevationService クラス

google.maps.ElevationService クラス
ライブラリ "elevation"

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

const {ElevationService} = await google.maps.importLibrary("elevation");
ElevationService
ElevationService()
パラメータ: なし
Google サーバーに標高クエリを送信する ElevationService の新しいインスタンスを作成します。
getElevationAlongPath
getElevationAlongPath(request[, callback])
パラメータ:
戻り値: Promise<PathElevationResponse>
パスに沿った高度リクエストを作成します。高度データはこのパスに沿った距離ベースのサンプルとして返されます。
getElevationForLocations
getElevationForLocations(request[, callback])
パラメータ:
戻り値: Promise<LocationElevationResponse>
離れた地点のリストに対する高度リクエストを作成します。

LocationElevationRequest インターフェース

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

ElevationService によって送信される高度リクエスト。高度データを返す個別の座標（LatLng）のリストが含まれます。
locations
省略可
タイプ: Array<LatLng|LatLngLiteral> optional
高度を取得する対象の、分散した地点。

LocationElevationResponse インターフェース

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

ElevationService によって返される標高レスポンス。LocationElevationRequest の位置に一致する ElevationResult のリストが含まれます。
results
LocationElevationRequest のロケーションに一致する ElevationResult のリスト。

PathElevationRequest インターフェース

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

ElevationService によって送信される高度クエリ。サンプリング データを返すパスが含まれます。このリクエストは、高度サンプルを等間隔で取得する地球上の連続したパスを定義します。すべてのパスは頂点から頂点まで、これらの 2 点間の大圏のセグメントを使用します。
samples
タイプ: number
必須。指定されたパスに沿って高度データを取得する等間隔のポイントの数（エンドポイントを含む）。サンプル数は 2 ～ 512 の値（両端の値を含む）にする必要があります。
path
省略可
タイプ: Array<LatLng|LatLngLiteral> optional
高度の値を収集するパス。

PathElevationResponse インターフェース

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

ElevationService によって返される標高レスポンス。PathElevationRequest のパスに沿って等間隔に配置された ElevationResult のリストが含まれます。
results
PathElevationRequest のサンプルに一致する ElevationResult のリスト。

ElevationResult インターフェース

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

ElevationService リクエストの結果。標高座標のセットとその標高値で構成されます。1 つのリクエストで複数の ElevationResult が生成されることがあります。
elevation
タイプ: number
この地点の海抜（メートル単位）。
resolution
タイプ: number
高度の補間に使われたサンプル地点間の距離（メートル単位）。解像度が不明の場合は、このプロパティは存在しません。なお、複数の地点が渡された場合は、高度データがより粗く（resolution の値が大きくなる）なります。各地点の最も正確な標高値を取得するには、個別に問い合わせをする必要があります。
location
省略可
タイプ: LatLng optional
この高度の結果の場所。

ElevationStatus 定数

google.maps.ElevationStatus constants
library "elevation"

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

これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは ElevationStatusString 型で定義されます。

const {ElevationStatus} = await google.maps.importLibrary("elevation");
INVALID_REQUEST リクエストは無効です。
OK リクエストに対してエラーが返されませんでした。
OVER_QUERY_LIMIT ウェブページは、短期間にリクエストの制限回数を超えました。
REQUEST_DENIED ウェブページでは Elevation サービスを使用できません。
UNKNOWN_ERROR 標高リクエストを正常に処理できませんでしたが、失敗の正確な理由は不明です。