YOLP（地図）
測地系変換API
Version 1
リクエストURL
XML
http://datum.search.olp.yahooapis.jp/OpenLocalPlatform/V1/datumConvert
JSONP
http://datum.search.olp.yahooapis.jp/OpenLocalPlatform/V1/datumConvert
リクエストパラメータ一覧
「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。
| パラメータ | 値 | 説明 |
|---|---|---|
| appid（必須） | string |
アプリケーションID。 詳細はこちらをご覧ください。 |
| coordinates（必須） | string |
変換する緯度経度。 経度、緯度の順で「,」で区切ります。緯度、経度はfloat型です。複数の緯度経度を指定する場合は「経度,緯度,経度,緯度,……」のように指定します。GETリクエストの場合は40点、POSTリクエストの場合は1000点まで同時に指定できます。 |
| datum |
string wgs tky（デフォルト） |
変換前の測地系。
|
| output |
string xml（デフォルト） json |
出力形式。
|
| callback | string |
コールバック関数。 outputパラメータがjsonのとき、JSONPとして出力する際のコールバック関数名を指定します。UTF-8でエンコードした文字列を指定します。 |
API使用上の注意
URLの最大の長さは2048バイトです。
URLエンコードを行って指定するパラメータもありますが、エンコード後のURLの長さが2048バイトを超えないようにしてください。
サンプルリクエストURL
東京都港区六本木の緯度経度を世界測地系から日本測地系に変換
http://datum.search.olp.yahooapis.jp/OpenLocalPlatform/V1/datumConvert?appid=<あなたのアプリケーションID>&coordinates=139.73359257419,35.662886299615&datum=wgs
レスポンス
出力形式にXMLを指定（output=xml）した場合、XMLを返します。レスポンスフィールドをご参照ください。
レスポンスフィールド
測地系変換APIのスキーマの記述は、以下のURLをご覧ください。
http://olp.yahooapis.jp/OpenLocalPlatform/V1/YDF.xsd
| フィールド | 説明 |
|---|---|
| YDF | クエリーレスポンスのすべてを含みます。 |
| ResultInfo | レスポンスのまとめ情報です。 |
| Count | レスポンス情報に含まれる変換された緯度経度のデータ件数です。 |
| Total | 変換された緯度経度以外も含めた全データ件数です。 |
| Start | レスポンス情報に含まれる変換された緯度経度の、全データからの取得開始位置です。 |
| Latency | レスポンス情報を生成するのに要した時間です。 |
| Status | リクエスト元に処理結果を伝えるためのコードです。 |
| Description | APIの説明文です。 |
| Copyright | コピーライトです。 |
| Feature | 変換結果1件分のデータ群です。 |
| Id | データの識別子です。 |
| Geometry | 変換後の地理座標データです。 |
| Type | 変換後の地理座標データの種類です。 |
| Coordinates | 変換後の緯度経度です。 |
| Datum | 変換後の緯度経度の測地系です。 |
このプログラムは、国土地理院長の承認を得て、同院の技術資料H・1-No.2「測地成果2000のための座標変換ソフトウェアTKY2JGD」を利用し作成したものである。（承認番号 国地企調第187号平成22年9月17日）
※地震等による地殻変動が生じた地域等で、必要としている精度を確保できない場合があります。
