YOLP(地図)

標高API

リクエストURL
XML
http://alt.search.olp.yahooapis.jp/OpenLocalPlatform/V1/getAltitude
JSONP
http://alt.search.olp.yahooapis.jp/OpenLocalPlatform/V1/getAltitude

目次




概要

  • 緯度経度で指定された場所の標高データを返します。
  • 標高、ジオイド高、楕円体高を返します。
  • 最大100点まで一度に取得できます。



リクエストパラメータ一覧

RESTリクエストの構築(GET)」および、「RESTリクエストの構築(POST)」をご参照ください。

パラメータ 説明
appid(必須) string アプリケーションID。
詳細はこちらをご覧ください。
coordinates(必須) string 緯度経度。
経度、緯度の順で「,」で区切ります。緯度、経度はfloat型です。複数の緯度経度を指定する場合は「経度,緯度,経度,緯度,……」のように指定します。
GETリクエストの場合は40点、POSTリクエストの場合は100点まで同時に指定できます。
output string
xml(デフォルト)
json
出力形式。
  • xml:XML形式
  • json: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 ジオイド高(単位:メートル)です。



サンプルレスポンス

以下は、東京都港区六本木付近の緯度経度のリクエストに対するレスポンスです。

XML形式

<?xml version="1.0" encoding="UTF-8"?>
<YDF xmlns="http://olp.yahooapis.jp/ydf/1.0" firstResultPosition="1" totalResultsAvailable="1" totalResultsReturned="1">
   <ResultInfo>
      <Count>1</Count>
      <Total>1</Total>
      <Start>1</Start>
      <Status>200</Status>
      <Latency>0</Latency>
      <Description/>
      <Copyright>(C) Yahoo Japan Corporation.</Copyright>
   </ResultInfo>
   <Feature>
      <Id>1</Id>
      <Geometry>
         <Type>point</Type>
         <Coordinates order="lon,lat">139.732293,35.663613</Coordinates>
      </Geometry>
      <Property>
         <Altitude>30</Altitude>
         <EllipsoidHeight>66.624161983353</EllipsoidHeight>
         <GeoidHeight>36.624161983353</GeoidHeight>
      </Property>
   </Feature>
</YDF>

JSON形式

{
    "ResultInfo":{
        "Count":1,
        "Total":1,
        "Start":1,
        "Status":200,
        "Latency":0,
        "Description":null,
        "Copyright":"(C) Yahoo Japan Corporation."
    },
    "Feature":[
        {
            "Id":1,
            "Geometry":{
                "Type":"point",
                "Coordinates":"139.732293,35.663613"
            },
            "Property":{
                "Altitude":30,
                "EllipsoidHeight":66.624161983353,
                "GeoidHeight":36.624161983353
            }
        }
    ]
}



エラー

コード 説明
400 渡されたパラメータがWeb APIで期待されたものと一致しない場合に返されます。

XML形式

<?xml version="1.0" encoding="UTF-8"?>
<Error>
   <Message>Bad Request</Message>
   <Detail>パラメータが不正です。</Detail>
   <Code>400</Code>
</Error>

JSON形式

{
    "Error":{
        "Message":"Bad Request",
        "Detail":"パラメータが不正です。",
        "Code":400
    }
}



このプログラムは、国土地理院長の承認を得て、同院発行の基盤地図情報及び日本のジオイド2000を複製したものである。(承認番号 平成22業複、第485号)

※地震等による地殻変動が生じた地域等で、必要としている精度を確保できない場合があります。