Staff Blog

2017.07.29

Geocoding API で取得できる住所タイプの仕様が変わります

みなさん、こんにちは。

2017年9月2018年1月以降に Google Maps Geocoding API の仕様が日本向けに一部変更されます。

今回は、その仕様変更の内容について解説していきたいと思います。

Google Maps Geocoding API を利用すると、現在以下のような結果が取得できます。以下は、弊社の住所「東京都千代田区神田錦町３－１１」でジオコードした結果です。

[
	{
		"address_components": [
			{
				"long_name": "１１",
				"short_name": "１１",
				"types": [
					"political",
					"sublocality",
					"sublocality_level_4"
				]
			},
			{
				"long_name": "３丁目",
				"short_name": "３丁目",
				"types": [
					"political",
					"sublocality",
					"sublocality_level_2"
				]
			},
			{
				"long_name": "神田錦町",
				"short_name": "神田錦町",
				"types": [
					"political",
					"sublocality",
					"sublocality_level_1"
				]
			},
			{
				"long_name": "千代田区",
				"short_name": "千代田区",
				"types": [
					"locality",
					"political"
				]
			},
			{
				"long_name": "東京都",
				"short_name": "東京都",
				"types": [
					"administrative_area_level_1",
					"political"
				]
			},
			{
				"long_name": "日本",
				"short_name": "JP",
				"types": [
					"country",
					"political"
				]
			},
			{
				"long_name": "101-0054",
				"short_name": "101-0054",
				"types": [
					"postal_code"
				]
			}
		],
		"formatted_address": "日本、〒101-0054 東京都千代田区神田錦町３丁目１１",
		"geometry": {
			"location": {
				"lat": 35.6921309,
				"lng": 139.76032810000004
			},
			"location_type": "ROOFTOP",
			"viewport": {
				"south": 35.69078191970849,
				"west": 139.75897911970856,
				"north": 35.69347988029149,
				"east": 139.76167708029152
			}
		},
		"place_id": "ChIJT5OqzA-MGGARLrl0nC90mwA",
		"types": [
			"political",
			"sublocality",
			"sublocality_level_4"
		]
	}
]

“address_componetns” には、住所の要素毎に “long_name”, “short_name”, “types” が設定されていることがわかりますね。今回、この中の “types” が変更されるようです。

以前もこの部分の仕様が微妙に変わったり、変わる可能性があるのではというブログの記事を書いたことがありましたが、今回がまさしくそのケースに当てはまります。

Geocoding APIの住所のタイプと住所コンポーネントのタイプ

Geocoding APIの微妙な仕様変更？

では、具体的にどのように変わるのかサンプルを例にして解説します。

例1. 東京都千代田区神田錦町３－１１

例2. 千葉県千葉市中央区栄町２０−１２

例3. 青森県青森市堤町１丁目１－７－２４

例4. 愛知県小牧市藤島町梵天１６４−３

例5. 埼玉県秩父郡長瀞町長瀞５９

まとめ

今回の仕様変更で、”colloquial_area”、”ward”、“sublocality_level_4”、”sublocality_level_5″ は使われなくなるそうです。また、街区、地番、枝番は “premise” に統合されます。全体的に、整理され分かり易くなっているような気もしますが、この仕様変更が良いことなのかは、現時点では何とも言えません。特に、街区、地番、枝番が統合されてしまうことで、変換がどのレベルまでできたかが、わかりづらくなりそうです。

以下は住所からジオコードを実行した結果を表示するサンプルですが、現時点で新しいジオコードを試すことはできないようです。その為、プログラムで変換して比較できるようにしています。参考にして頂ければと思います。

こちらの仕様変更の続報がありましたら、またこのブログでお知らせしたいと思います。

2017年10月21日 修正

仕様が変わり、”sublocality_level_4″ が街区として復活するようです。

変更時期は、2018年1月以降になりそうです。

2018年1月30日 追記

2018年1月30日 12:00頃に、新しい仕様に変更されました！