現在位置: トップ > YOLP公式ブログ > Tips > 郵便番号検索であなたのアプリをパワーアップ! ~ 郵便番号検索APIの活用法 ~

ここから本文です

郵便番号検索であなたのアプリをパワーアップ! ~ 郵便番号検索APIの活用法 ~

[Tips]  2012年11月9日
こんにちは、Yahoo! Open Local Platform (YOLP)の櫻井です。いつもYOLPをご利用いただきありがとうございます。
以前、郵便番号を指定すると住所などが取得できる郵便番号検索API のお知らせをしましたが、今回こちらのAPIを使った便利な機能を2つご紹介したいと思います。

※基本的な使い方についてはこちらを合わせてご覧ください。


住所構造ごとのデータを取得する

郵便番号検索APIは、標準では「東京都港区芝公園」と連結された住所文字列を返します。しかし、「東京都」「港区」「芝公園」と住所の階層ごとに分割されたデータを取得したい場合もあるかと思います。
そのようなケースでは「detail=full」パラメータを付与することで、AddressElement要素として階層ごとに分割されたデータを合わせて取得できます。
〒105-0011でのリクエスト方法とそのレスポンスを見てみましょう。

郵便番号検索API リクエストパラメータ
http://search.olp.yahooapis.jp/OpenLocalPlatform/V1/zipCodeSearch?appid=<あなたのアプリケーションID>&query=105-0011&detail=full
<あなたのアプリケーションID>には、ご自身のアプリケーションIDを入れてください。アプリケーションIDについてはこちらをご覧ください。


レスポンス
~省略~
<Address>東京都港区芝公園</Address>
<AddressElement>
  <Name>東京都</Name>
  <Kana>とうきょうと</Kana>
  <Level>prefecture</Level>
</AddressElement>
<AddressElement>
  <Name>港区</Name>
  <Kana>みなとく</Kana>
  <Level>city</Level>
</AddressElement>
<AddressElement>
  <Name>芝公園</Name>
  <Kana>しばこうえん</Kana>
  <Level>oaza</Level>
</AddressElement>
~省略~

指定した郵便番号の場所の地図を表示する

郵便番号検索APIでは緯度経度情報も取得できます。さきほどのAPIの結果から、検索した郵便番号の場所の地図を表示できます。〒105-0011の地図を表示してみましょう。

郵便番号検索API リクエストパラメータ
http://search.olp.yahooapis.jp/OpenLocalPlatform/V1/zipCodeSearch?appid=<あなたのアプリケーションID>&query=105-0011&detail=full
レスポンス
~省略~
<Geometry>
  <Type>point</Type>
  <Coordinates>139.74816650,35.65757726</Coordinates>
</Geometry>
~省略~

この結果をYahoo!スタティックマップAPIで表示するには、以下のように指定します。

Yahoo!スタティックマップAPI リクエストパラメータ
http://map.olp.yahooapis.jp/OpenLocalPlatform/V1/static?appid=<あなたのアプリケーションID>&lat=35.65757726&lon=139.74816650&z=17&mode=map&width=600&height=450&pointer=on&style=base:standard
Yahoo!スタティックマップAPI 地図表示


また、Yahoo!スタティックマップAPIのパラメータにYDF(YOLP Data Format)のURLを指定することで、YDFに記載された拠点情報を地図上に表示させることもできます。今回設定した郵便番号検索APIのURLと連携させてパラメータを指定してみましょう。

Yahoo!スタティックマップAPI リクエストパラメータ
http://map.olp.yahooapis.jp/OpenLocalPlatform/V1/static?appid=<あなたのアプリケーションID>&mode=map&width=600&height=450&z=17&icon_num=on&icon_label=on&view=normal&url=http%3A%2F%2Fsearch.olp.yahooapis.jp%2FOpenLocalPlatform%2FV1%2FzipCodeSearch%3Fappid%3D<あなたのアプリケーションID>%26query%3D105-0011%26detail%3Dfull
Yahoo!スタティックマップAPI 郵便番号情報を表示


最後に

YOLPではデベロッパーやユーザーが便利に位置情報コンテンツを利用できるよう、郵便番号をはじめ施設情報や住所など地図に関するさまざまなAPI・SDKを提供しています。Yahoo!ローカルサーチAPIYahoo! iOSマップSDKYahoo! AndroidマップSDKなどのラインナップがありますので、こちらもぜひご活用ください。
今後ともYOLPをよろしくお願いいたします。

YOLPへのご感想やご意見などはFacebookページTwitterアカウント宛に投稿ください。
Facebookページへの
やTwitterアカウントの
RSSリーダーの登録もよろしくお願いします。
グーグルリーダーに登録  Subscribe with livedoor Reader  My Yahoo!に追加

関連する記事


Yahoo!地図アプリ iPhone版/Android版(無料)
Yahoo!地図ブログ
本文はここまでです このページの先頭へ