ElevationService クラス
google.maps.ElevationService
クラス
Google サーバーと直接通信して高度データをリクエストするサービス クラスを定義します。
v=beta
を使用している場合は、const {ElevationService} = await google.map.importLibrary("elevation")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
ElevationService |
ElevationService() パラメータ: なし
Google サーバーに高度クエリを送信する ElevationService の新しいインスタンスを作成します。 |
Methods | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) パラメータ:
戻り値:
Promise<PathElevationResponse> パスに沿った高度リクエストを作成します。高度データはこのパスに沿った距離ベースのサンプルとして返されます。 |
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
などです。
v=beta
を使用している場合は、const {ElevationStatus} = await google.map.importLibrary("elevation")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
INVALID_REQUEST |
リクエストは無効です。 |
OK |
リクエストに対してエラーが返されませんでした。 |
OVER_QUERY_LIMIT |
ウェブページは、短期間にリクエストの制限回数を超えました。 |
REQUEST_DENIED |
ウェブページで高度サービスを使用することはできません。 |
UNKNOWN_ERROR |
高度リクエストを処理できませんでした。失敗の正確な理由は不明です。 |