Amazon Location Serviceで郵便番号から住所検索をする

March 08, 2022

住所を入力するフォームでよくある、郵便番号を入力すると住所が補完される例の機能（以降は、郵便番号検索とします）を実装する必要があったのAmazon Location Serviceが使えないか調べてみました。

郵便番号検索のSaaSとして、¹様々なサービスがありますが、AWSで環境を揃えたいなどの理由もありAmazon Location Serviceに白羽の矢が立ちました。

Amazon Location Serviceでの郵便番号検索にはGeocodingのSearchPlaceIndexForTextを利用します。

PlaceIndexの作成

まず、「場所インデックス」を作成します。次のコマンドを実行すると「場所インデックス」を作成できます。マネージメントコンソールから作成しても大丈夫ですが、データプロバイダーとして必ず²Hereを選択してください。

$ aws location create-place-index
    --data-source Here \
    --description "PostalCode Index" \
    --index-name PostalCodePlaceIndex

SearchPlaceIndexForTextで検索

「場所インデックス」が作成できたら、早速郵便番号検索をしてみます。今回はAWS CLIを使って検索してみました。

検索は次のコマンドを実行して行います。郵便番号は--textオプションで指定します。検索結果には日本だけを含むようにしたいので--filter-countries JPNオプションも指定しています。

$ aws location search-place-index-for-text \
  --index-name PostalCodePlaceIndex \
  --language ja \
  --filter-countries JPN \
  --text <postalCode>

市区町村パターン

最初に、郵便番号1010041(東京都千代田区神田須田町)を検索してみます

結果は、次のようにResults.Placeに東京都千代田区神田須田町が含まれています。レスポンス内のPlaceオブジェクトの各属性が住所フィールドの補完に利用できそうです。

それぞれの見ていくと、以下のような構成になっているようです。公式ドキュメントのPlaceの記述と照らし合わせても一致します。

Label: 郵便番号を含む住所全体
Municipality: 市区町村
PostalCode: 郵便番号
Region: 都道府県

ただ、神田須田町だけを持った属性はなさそうです。レスポンスの値を住所フィールドの補完に利用する際に神田須田町（所謂、町域名）の部分はLabelから抽出する必要がありそうです。

{
    "Results": [
        {
            "Place": {
                "Country": "JPN",
                "Geometry": {
                    "Point": [
                        139.77105,
                        35.69593
                    ]
                },
                "Interpolated": false,
                "Label": "〒101-0041 東京都千代田区神田須田町",
                "Municipality": "千代田区",
                "PostalCode": "101-0041",
                "Region": "東京都",
                "TimeZone": {
                    "Name": "Asia/Tokyo",
                    "Offset": 32400
                }
            }
        }
    ],
    "Summary": {
        "DataSource": "Here",
        "FilterCountries": [
            "JPN"
        ],
        "Language": "ja",
        "MaxResults": 50,
        "ResultBBox": [
            139.77105,
            35.69593,
            139.77105,
            35.69593
        ],
        "Text": "1010041"
    }
}

郡パターン

○○郡xx町というような住所のパターンの検索です。ここでは郵便番号1901211(東京都西多摩郡瑞穂町石畑)を検索してみます。コマンドは--textオプションに指定する郵便番号以外は直前のものと同じになるので、以降の記載は省略します。

結果は次の通りです。先程と違いSubRegionという属性が存在しています。値は西多摩郡です。SubRegionが○○郡の部分に該当するようです。

{
    "Results": [
        {
            "Place": {
                "Country": "JPN",
                "Geometry": {
                    "Point": [
                        139.35873,
                        35.76639
                    ]
                },
                "Interpolated": false,
                "Label": "〒190-1211 東京都西多摩郡瑞穂町石畑",
                "Municipality": "瑞穂町",
                "PostalCode": "190-1211",
                "Region": "東京都",
                "SubRegion": "西多摩郡",
                "TimeZone": {
                    "Name": "Asia/Tokyo",
                    "Offset": 32400
                }
            }
        }
    ],
    "Summary": {
        "DataSource": "Here",
        "FilterCountries": [
            "JPN"
        ],
        "Language": "ja",
        "MaxResults": 50,
        "ResultBBox": [
            139.35873,
            35.76639,
            139.35873,
            35.76639
        ],
        "Text": "1901211"
    }
}

行政区パターン

次に札幌市中央区のような特別区以外の区（所謂、行政区）の郵便番号0600035(北海道札幌市中央区北5条東)を検索してみます。

結果は次の通りです。Neighborhoodという属性が存在しています。値は中央区です。、Neighborhoodが行政区の部分に相当しそうです。

{
    "Results": [
        {
            "Place": {
                "Country": "JPN",
                "Geometry": {
                    "Point": [
                        141.35752,
                        43.06827
                    ]
                },
                "Interpolated": false,
                "Label": "〒060-0035 北海道札幌市中央区北5条東",
                "Municipality": "札幌市",
                "Neighborhood": "中央区",
                "PostalCode": "060-0035",
                "Region": "北海道",
                "TimeZone": {
                    "Name": "Asia/Tokyo",
                    "Offset": 32400
                }
            }
        }
    ],
    "Summary": {
        "DataSource": "Here",
        "FilterCountries": [
            "JPN"
        ],
        "Language": "ja",
        "MaxResults": 50,
        "ResultBBox": [
            141.35752,
            43.06827,
            141.35752,
            43.06827
        ],
        "Text": "0600035"
    }
}

ここまでの結果から、Placeの属性と日本の住所の構成要素は以下のようマッピングできそうです。

PostalCode: 郵便番号
Region: 都道府県
SubRegion: 郡
Municipality: 市区町村
Neighborhood: 行政区(特別区除く)
Label: 郵便番号を含む住所全体

また、それぞれの属性値を結合するような場合は、住所文字列をとしても上記の順番でよさそうです。

その他のパターン

さらに、もう少し別のパターンも検索してみます。

個別の郵便番号が設定されている高層ビルのパターンはどうでしょう。郵便番号1006001(東京都千代田区霞が関霞が関ビル（１階）)を検索してみます。結果は次の通りです。結果は0件です。すべての検証したわけではありませんが高層ビルなどの建物の階毎に割り振られた郵便番号では検索できないようです。この他にも、1001701(東京都青ヶ島村)などいくつかの郵便番号で検索結果が0件になりました。他の離島³では検索できる郵便番号もあるので、離島だから必ず検索できないわけではないようです。検索できるかできないかはデータプロバイダーが提供するデータ次第になりそうです。

{
    "Results": [],
    "Summary": {
        "DataSource": "Here",
        "FilterCountries": [
            "JPN"
        ],
        "Language": "ja",
        "MaxResults": 50,
        "Text": "1006001"
    }
}

まとめ

PlaceIndexにはHereを使う。
Placeの属性と日本の住所のマッピングはこれ。
- PostalCode: 郵便番号
- Region: 都道府県
- SubRegion: 郡
- Municipality: 市区町村
- Neighborhood: 行政区(特別区除く)
- Label: 郵便番号を含む住所全体
検索できない郵便番号もある（データプロバイダーが提供するデータ次第）。

以上から、郵便番号検索にAmazon Location Serviceを採用するかは要件次第になると思います。存在する郵便番号を完全に網羅しているわけではないので、その点が重要であれば少なくとも現時点では別の方法（別のSaaS、自前でデータ管理）を採用するのが良さそうです。一方、一部検索できない郵便番号があることが許容できるのであれば、AWS上で郵便番号検索を簡単に実装できる選択肢になると思います。データの更新はデータプロバイダーにお任せできる点も自前データ管理と比較するとメリットになりますし、Google Mapsと比較しても料金はAWSがお得になりそうです。

Google MapsのGeocofing APIやケンオールなどがあります。 ↩
データプロバイダーとしてHere以外にEsriもありますが、Esriでは日本の郵便番号での検索はできませんでした(どの郵便番号でも結果が0件でした)。 ↩
離島でも9980281(山形県酒田市飛島)は検索結果を取得できました。 ↩