Elevation

ElevationService クラス

google.maps.ElevationService クラス

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

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

LocationElevationRequest インターフェース

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

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

LocationElevationResponse インターフェース

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

ElevationService から返される、LocationElevationRequest の位置に一致する ElevationResult のリストを含む高度レスポンス。
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 インターフェース

ElevationService が返す高度レスポンス。PathElevationRequest のパスに沿って等間隔に配置された ElevationResult のリストが含まれます。
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 昇格リクエストを正常に処理できませんでしたが、エラーの正確な理由は不明です。