YOLP（地図）
標高API
Version 1
リクエストURL
XML
http://alt.search.olp.yahooapis.jp/OpenLocalPlatform/V1/getAltitude
JSONP
http://alt.search.olp.yahooapis.jp/OpenLocalPlatform/V1/getAltitude
リクエストパラメータ一覧
「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。
| パラメータ | 値 | 説明 |
|---|---|---|
| appid（必須） | string |
アプリケーションID。 詳細はこちらをご覧ください。 |
| coordinates（必須） | string |
緯度経度。 経度、緯度の順で「,」で区切ります。緯度、経度はfloat型です。複数の緯度経度を指定する場合は「経度,緯度,経度,緯度,……」のように指定します。 GETリクエストの場合は40点、POSTリクエストの場合は100点まで同時に指定できます。 |
| output |
string xml（デフォルト） json |
出力形式。
|
| callback | string |
コールバック関数。 outputパラメータがjsonのとき、JSONPとして出力する際のコールバック関数名を指定します。UTF-8でエンコードした文字列を指定します。 |
API使用上の注意
URLの最大の長さは2048バイトです。
URLエンコードを行って指定するパラメータもありますが、エンコード後のURLの長さが2048バイトを超えないようにしてください。
サンプルリクエストURL
東京都港区六本木付近の緯度経度から標高を取得
http://alt.search.olp.yahooapis.jp/OpenLocalPlatform/V1/getAltitude?appid=<あなたのアプリケーションID>&coordinates=139.732293,35.663613
レスポンス
出力形式にXMLを指定（output=xml）した場合、XMLを返します。レスポンスフィールドをご参照ください。
レスポンスフィールド
標高APIのスキーマの記述は、以下のURLをご覧ください。
http://olp.yahooapis.jp/OpenLocalPlatform/V1/YDF.xsd
| フィールド | 説明 |
|---|---|
| YDF | クエリーレスポンスのすべてを含みます。 |
| ResultInfo | レスポンスのまとめ情報です。 |
| Count | レスポンス情報に含まれる標高情報のデータ件数です。 |
| Total | 出力された標高情報以外も含めた全データ件数です。 |
| Start | レスポンス情報に含まれる標高情報の、全データからの取得開始位置です。 |
| Latency | レスポンス情報を生成するのに要した時間です。 |
| Status | リクエスト元に処理結果を伝えるためのコードです。 |
| Description | データの説明です。詳細情報がある場合に表示されます。 |
| Copyright | コピーライトです。 |
| Feature | 1件分のデータ群です。 |
| Id | データの識別子です。 |
| Geometry | 地理座標データです。 |
| Type | 地理座標データの種類です。 |
| Coordinates | 座標情報です。 |
| Property | 各種データを格納します。 |
| Altitude | 標高（単位：メートル）です。 |
| EllipsoidHeight | 楕円（だえん）体高（単位：メートル）です。（楕円体高＝標高＋ジオイド高） |
| GeoidHeight | ジオイド高（単位：メートル）です。 |
このプログラムは、国土地理院長の承認を得て、同院発行の基盤地図情報及び日本のジオイド2000を複製したものである。（承認番号 平成22業複、第485号）
※地震等による地殻変動が生じた地域等で、必要としている精度を確保できない場合があります。
