XML-RPCサービス - 郵便専門ネット

郵便専門ネットでは、XML-RPCを使って、郵便番号の存在チェックや住所の取得ができます。

郵便専門ネットのXML-RPC API (ver.3.0.0)

接続情報

ホスト名yubin.senmon.net
ポート番号80 or 443
パス/service/xmlrpc/
Top

メソッド一覧

戻り値 メソッド (パラメータ) 機能
string yubin.getVersion () 郵便番号データのバージョン文字列を返します。
int yubin.getMaxFetchCount () 一度に取得できるデータ件数を返します。
int yubin.getFetchCountByPostcode (string postcode) 引数に指定した郵便番号で何件ヒットするのかをint型で返します。 yubin.fetchAddressByPostcodeで途中で切れてしまった場合でも、このメソッドで何件ヒットしたのかを調べることができます。
string yubin.getPrefName (string prefectureCode) 引数に都道府県のコード(地方公共団体コードの先頭2文字)を渡すと都道府県名を返します。
boolean yubin.postcodeExists (string postcode) 郵便番号で存在チェックし、存在したらtrue、存在しなければfaultを返します。
string yubin.postcodeToJiscode (string postcode) 郵便番号を5桁の全国地方公共団体コード/JISコード/市町村コードに変換して返します。
string yubin.postcodeToJiscode6 (string postcode) 郵便番号を6桁(チェックデジット付き)の全国地方公共団体コード/JISコード/市町村コードに変換して返します。
array of string yubin.postcodeFromJiscode (string jiscode) JISコード(5桁、6桁どちらでも)から、その市区町村に属している郵便番号のリストを返します。 戻り値は文字列のリストです。
array of string yubin.jiscodeFromPrefcode (string prefectureCode) 引数に都道府県のJISコード(JISコードの先頭2文字)を渡すと、その都道府県に属しているJISコードのリストを返します。 戻り値は文字列のリストです。
array of string yubin.postcodeToGeocode (string postcode) 郵便番号に対応する世界測地系(WGS84)の緯度経度コード(Geocode)を返します。 戻り値は緯度と軽度の2つの値を持った文字列のリストです。
array of struct yubin.fetchAddressByPostcode (string postcode) 郵便番号から住所を返す。事業所の郵便番号だった場合は事業所の住所を返します。 パラメータのpostcodeには完全一致で検索するので7桁の郵便番号を全て指定してください。 7桁に満たない場合や、7桁より長い場合はFaultが返ります。 戻り値はstructのarrayで返ってきます。structの項目は以下の通り。

struct 住所情報型

※文字コードはXMLの規約に従います。
項目 フィールド名 説明
郵便IDyidint郵便番号データにはユニークなIDが付いていない。管理上必要なため当方で発番したもの。このIDは全国郵便番号一覧のバージョンが変ると同じIDが別の住所、事業所に割り振られる可能性がある。
データタイプdata_typestringp=住所、j=事業所
地方公共団体コードjiscodestring
郵便番号postcodestring
都道府県名prefstringUTF-8
都道府県名カナpref_kanastringUTF-8;data_type=pのみ
市区citystringUTF-8
市区カナcity_kanastringUTF-8;data_type=pのみ
町村townstringUTF-8
町村カナtown_kanastringUTF-8;data_type=pのみ
事業所名addr_namestringUTF-8;data_type=jのみ
事業所名カナaddr_name_kanastringUTF-8;data_type=jのみ
町域番地otherstringUTF-8;data_type=jのみ
Top

エラー

803

パラメータが不正の場合に返るエラーコードです。

804

アクセス頻度が高い場合に発生するえらーコードです。
現時点では1分間に300回以上のアクセスを一定期間継続した場合に発生します。
この制限を超えることが想定される場合は、事前にwebmaster@fabrice.co.jpまで用途などの情報と共にお問合せください。

Top

サンプル

Delphiによる使用例

Windows用のXML-RPCクライアント(フリーソフト)をご覧ください。 以下からダウンロードしてご利用頂けます。
ファブリス-ソフトウエア
Delphi5のソースと郵便専門ネット用のリクエストファイルを同梱しています。 XML-RPCを利用したサイトの開発者の方には便利だと思います。どうぞご利用ください。
シンプルな検索機能の例として、郵便専門ネットクライアント(フリーソフト)をご覧ください。 当サイトのXML-RPC APIを実装したものです。ダウンロードしてご利用頂けます。 ソースは添付していませんが、ほとんどは上のXML-RPCクライアントのソースから流用したものです。

Pythonによる使用例

XML-RPCで郵便番号から住所を取得するPythonスクリプトをご覧ください。 Delphi、PHP、Pythonでは圧倒的にPythonが簡単です。標準ライブラリだけで動きます。 (2006.4.14)

PHPによる使用例

PHP版のXML-RPCクライアント のサンプルクラスをご覧下さい。 (2007.12.9)

Top