June 13, 2006 4:15 PM by funami

フナミタカオです。

6/12に開催された、Geo Developer Dayにて、 Google Maps APIのバージョンアップが発表されました。
このバージョンアップにより、ついにジオコーディング（住所から、緯度経度を算出する機能）ができるようになりました。
このことについては、大井研究員も書いていますが、僕たちが一番望んでいた機能をリリースしてもらったということで、早速、サンプルをためしてみました。

「GoogleMapsAPIによるジオコーディングのサンプル」をご覧ください。

ドキュメントは、Geocoding using JavaScript@Google Maps API Version 2 Documentation←こちらにあり、サンプルも載っているのですが、このサンプルは、６月１３日１５時３０分（日本時間）現在、エラーがでて動作していません。6/14 5:20、動くことを確認しました。
そこで、たたみラボのサーバーにて、サンプルソースを動くようにしました。
「GoogleMapsAPIによるジオコーディングのサンプル」をご覧ください。

特徴

・日本語に対応
・クライアントサイドで、クエリ結果をデフォルトでキャッシュする。これにより、同じ地名の検索は、サーバーに問い合わせることなく、表示される。
・複数の検索結果を取得する場合には、getLocations(address, callback)メソッドを使用する。複数の検索結果があっても、１件だけの戻りでよければgetLatLng(address, callback)メソッドを利用する。
・HTTPリクエストを使用して、XMLで検索結果を取得することも可能。KMLという、位置を記述する形式でもどる。このKMLはGoogleEarthでも位置を示す標準フォーマットになっていて、位置情報記述の標準を目指しているらしい。


勝どき検索の例。q=の値である%E5%8B%9D%E3%81%A9%E3%81%8Dは「勝どき」をURLエンエンコードした文字列
http://maps.google.com/maps/geo?q=%E5%8B%9D%E3%81%A9%E3%81%8D&output=xml&key=**key**
**key**は、APIキー

<?xml version="1.0" encoding="UTF-8"?>

<kml xmlns="http://earth.google.com/kml/2.0">

<Response>

<name>勝どき</name>

<Status>

<code>200</code>

<request>geocode</request>

</Status>

<Placemark>

<ddress>日本東京都中央区勝どき</address>

<AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">

<Country>

<CountryNameCode>JP</CountryNameCode>

<AddressLine>東京都中央区勝どき</AddressLine>

</Country>

</AddressDetails>

<Point>

<coordinates>139.775693,35.658192,0</coordinates>

</Point>

</Placemark>

</Response>

</kml>

output=jsonとすると、JSONオブジェクトで結果が返る。そのまま使えて便利。しかし、ここで気づいたのだが、jsonの場合は、複数の候補が戻るが、XMLの場合は１つだけ、同じクエリなのに、異なる結果になるのは、不具合かも。

{name: "勝どき",Status: {code: 200, request: "geocode"}, Placemark: [{address: "日本東京都中央区勝どき",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき"]}},Point: {coordinates: [139.775693, 35.658192, 0]}},{address: "日本東京都中央区勝どき２丁目",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき２丁目"]}},Point: {coordinates: [139.778483, 35.658512, 0]}},{address: "日本東京都中央区勝どき１丁目",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき１丁目"]}},Point: {coordinates: [139.776407, 35.660269, 0]}},{address: "日本東京都中央区勝どき３丁目",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき３丁目"]}},Point: {coordinates: [139.774642, 35.658757, 0]}},{address: "日本東京都中央区勝どき４丁目",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき４丁目"]}},Point: {coordinates: [139.776068, 35.657078, 0]}},{address: "日本東京都中央区勝どき６丁目",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき６丁目"]}},Point: {coordinates: [139.772370, 35.654995, 0]}},{address: "日本東京都中央区勝どき１丁目１３",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき１丁目１３"]}},Point: {coordinates: [139.775301, 35.660774, 0]}},{address: "日本東京都中央区勝どき６丁目５",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき６丁目５"]}},Point: {coordinates: [139.772233, 35.654974, 0]}},{address: "日本東京都中央区勝どき５丁目",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき５丁目"]}},Point: {coordinates: [139.771538, 35.656603, 0]}},{address: "日本東京都中央区勝どき６丁目５−２３",AddressDetails: {Country: {CountryNameCode: "JP", AddressLine: ["東京都中央区勝どき６丁目５−２３"]}},Point: {coordinates: [139.771969, 35.654884, 0]}}]}

・一日のクエリ件数は５００００件に制限されているので、ユーザーが多いサイトでは要注意。
・緯度経度抽出のアルゴリズムは、GoogleMapsと同じ。