ZIP SEARCH API SERVICE 「JIS X0401」対応版ver 1.0.0

サービス概要

ZIP SEARCH API SERVICE 「JIS X0401」対応版 の特徴

  • 郵便番号(3桁+4桁)から住所を検索するAPI「ZIP SEARCH API SERVICE」の JIS X0401(都道府県コード)対応版を開始しました。
  • 本サービスでは新たに住所から郵便番号を検索するためのデータも提供します。
  • JavascriptでもPHPでも扱いやすいようデータ形式もJSONP、JSONで無料提供します。
  • リクエスト方法は従来の「ZIP SEARCH API SERVICE」とは異なります。詳しくは解説をご覧ください。
  • 住所データは月初にデータベースを自動更新しています。

サンプルページ

郵便番号から住所情報を検索した例

住所情報から郵便番号を検索した例

解説:郵便番号から住所を検索する場合

表示するWebページのフォーマット

  • XHTML形式、文字コードはutf-8です。
  • javascriptの文字コードはutf-8です。(受け取るデータには日本語文字列が含まれます。)

JSONPのリクエスト

			
	//リクエスト書式
		http://api.thni.net/jzip/X0401/JSONP/郵便番号上3桁の数値/郵便番号下4桁の数値.js
		
	//例 http://api.thni.net/jzip/X0401/JSONP/064/0941.js
			

JSONPの取得データ型

			
	//取得データ例		
		ZipSearchValue({ "state":"1", "stateName":"北海道", "city":"札幌市中央区", "street":"旭ケ丘" })
			

JSONのリクエスト

			
	//リクエスト書式
		http://api.thni.net/jzip/X0401/JSON/郵便番号上3桁の数値/郵便番号下4桁の数値.js
		
	//例 http://api.thni.net/jzip/X0401/JSON/064/0941.js
			

JSONの取得データ型

			
	//取得データ例
		{ "state":"1", "stateName":"北海道", "city":"札幌市中央区", "street":"旭ケ丘" }
			

配列キー

			
	// "state" サンプルページの都道府県選択利用の場合のoption value			
	// "stateName" 都道府県名
	// "city" 市・区・群名
	// "street" : 町・村名
			

解説:住所情報から郵便番号を検索する場合

表示するWebページのフォーマット

  • XHTML形式、文字コードはutf-8です。
  • javascriptの文字コードはutf-8です。(受け取るデータには日本語文字列が含まれます。)

リクエストについて

  • 各住所情報を段階的に取得して郵便番号を検索することができます。
  • リクエストするアドレスには日本語が含まれますので、日本語の部分にはencodeURIをかけてリクエストしてください。

JSONPのリクエスト

	
	//都道府県リストをリクエスト
		例 http://api.thni.net/jzip/X0401/JSONP/J/state_index.js
	
	//取得データ型 StateIndex([{"name":"北海道","kana":"ホッカイドウ"}, {...}])
	
	--▼----------------------------------
	
	//市・区・群リストをリクエスト (都道府県名をディレクトリの要領で以下のようにリクエスト※)
		例 http://api.thni.net/jzip/X0401/JSONP/J/北海道/city_index.js	
	
	//取得データ型 CityIndex([{"name":"札幌市中央区","kana":"サッポロシチュウオウク"},{...}])
	
	--▼----------------------------------
	
	//町・村リストをリクエスト(都道府県名、市・区・群をディレクトリの要領で以下のようにリクエスト※)
		例 http://api.thni.net/jzip/X0401/JSONP/J/北海道/札幌市中央区/street_index.js
	
	//取得データ型 
		StreetIndex([{"name":"以下に掲載がない場合","kana":"イカニケイサイガナイバアイ"}, {"name":"旭ケ丘","kana":"アサヒガオカ"}'{...}])
	
	--▼----------------------------------
	
	//郵便番号リクエスト(都道府県名、市・区・群、町・村をディレクトリの要領で以下のようにリクエスト※)
		例 http://api.thni.net/jzip/X0401/JSONP/J/北海道/札幌市中央区/旭ケ丘.js
	
	//取得データ型
		KenSearchValue({ "zipcode":"064-0941", "state":"北海道", "city":"札幌市中央区", "street":"旭ケ丘",
	           "state_kana":"ホッカイドウ", "city_kana":"サッポロシチュウオウク", "street_kana":"アサヒガオカ" })
	
	--■ご注意----------------------------------
	
	※日本語の部分にはencodeURIをかけてリクエストしてください。
			

JSONのリクエスト

	
	//都道府県リストをリクエスト
		例 http://api.thni.net/jzip/X0401/JSON/J/state_index.js
	
	//取得データ型 [{"name":"北海道","kana":"ホッカイドウ"},{...}]
	
	--▼----------------------------------
	
	//市・区・群リストをリクエスト(都道府県名をディレクトリの要領で以下のようにリクエスト※)
		http://api.thni.net/jzip/X0401/JSON/J/北海道/city_index.js	
	
	//取得データ型 [{"name":"札幌市中央区","kana":"サッポロシチュウオウク"},{...}]
	
	--▼----------------------------------
	
	//町・村リストをリクエスト(都道府県名、市・区・群をディレクトリの要領で以下のようにリクエスト※)
		例 http://api.thni.net/jzip/X0401/JSON/J/北海道/札幌市中央区/street_index.js
	
	//取得データ型 
		[{"name":"以下に掲載がない場合","kana":"イカニケイサイガナイバアイ"}, {"name":"旭ケ丘","kana":"アサヒガオカ"},{...}]
	
	--▼----------------------------------
	
	//郵便番号リクエスト(都道府県名、市・区・群、町・村をディレクトリの要領で以下のようにリクエスト※)
		例 http://api.thni.net/jzip/X0401/JSON/J/北海道/札幌市中央区/旭ケ丘.js
	
	//取得データ型
		{ "zipcode":"064-0941", "state":"北海道", "city":"札幌市中央区", "street":"旭ケ丘",
	         "state_kana":"ホッカイドウ", "city_kana":"サッポロシチュウオウク", "street_kana":"アサヒガオカ" }
	
	--■ご注意----------------------------------
	
	※日本語の部分にはencodeURIをかけてリクエストしてください。
			

配列キーについて

			
	//郵便番号リクエスト時の配列キー
	"zipcode":郵便番号
	"state":都道府県名
	"city":市・区・群名
	"street":町・村名
			

ご注意事項とお願い

  • 必ずご利用規約をお読みいただき、同意の上ご利用ください。
  • 内容及び動作、仕様、サービス自体の提供について予告なしに変更、または中止する場合がございます。
  • 本サービスはネットワーク状況やメンテナンスその他の要因により、一時機能しない場合がございます。

ご利用規約

  • 著作権は、「IW3 PROJECT」が保有します。
  • 当サイトのサービスを利用した時点で当規約に同意したものとみなします。
  • 個人・法人・商用・非商用問わず無料でご利用可能です。
  • 各種コンテンツ等の無断転用を禁じます。
  • 本サービスの使用又は使用不能から生じるお客様の損害について、当社は一切の責任を負いません。
  • 管理人が不適当と判断した場合、設置・利用・公開を中止していただく場合があります。
  • このページの内容(著作権・免責事項・その他)は変更する場合があります。