# Amazonアカウントから取得した住所や姓名を分割したいです

Amazonアカウントから取得できる名前は、姓名で分かれておらず、住所も同様に市区町村、町域、番地のような区分で分かれていません。

当サンプルコードを利用することで、
名前を「姓」「名」
住所を「市区町村」「町域」「番地」「マンション・建物名」
に分割することができます。

# Amazonアカウントの名前・住所情報の構造
[アカウント情報として何が取得できますか？](https://www.amazonpay-faq.jp/faq/QA-8)を確認してください。

# サンプルコード
[amazonpay-divider](https://github.com/amazonpay-labs/amazonpay-divider)よりサンプルコードを取得してください。

# 名前の分割方法

Amazonアカウントの名前（shippingAddress.name または billingAddress.name）を、姓と名に分割します。

### Amazonアカウントの住所：レギュラーな構造の例

| 項目名  | 説明 | 備考 |
| ------------- | ------------- | ------------- |
| Name | 名前  |姓名で分かれていません。例）佐藤太郎 |

### サンプルコードで分割後の構造

| 項目  | 説明 | 例 |
| ------------- | ------------- |------------- |
| LastName | 姓  |例）佐藤 |
| LastNamePronunciation | 姓読み  |例）さとう |
| FirstName | 名  |例）太郎 |

※名読みは対応していません。
　名読みを予測し取得する方法は、[姓名分割及びフリガナ予測を行うサンプルコード](https://github.com/itoshige/lucene-kuromoji-sample)を参照してください。

# 住所の分割方法

下記のように、Amazonアカウント住所のAddressLine1、AddressLine2およびAddressLine3の内容を
市区町村、町域、番地、および、マンション・建物名に分割します。

### Amazonアカウントの住所：レギュラーな構造の例

| 項目  | 説明 | 例 |
| ------------- | ------------- |------------- |
| PostalCode | 郵便番号 | 153-0064 |
| StateOrRegion | 都道府県名 | 東京都 |
| AddressLine1 | 住所１ | 目黒区下目黒 |
| AddressLine2 | 住所２  | １丁目８−１ |
| AddressLine3 | 住所３ | アルコタワーアネックス | 

※ Amazonアカウントの住所の構造は、必ずしも上記のように市区町村や町域などがAddressLine1、AddressLine2に綺麗に入るとは限らないため、
　これを下記「サンプルコードで分割・取得できる住所構造」のように分割します。
　詳細は[こちら](https://www.amazonpay-faq.jp/faq/QA-8)の、「アドレス帳(お届け先住所)、請求先住所に関する留意点」を参照してください。

### サンプルコードで分割後の住所構造

| 項目  | 説明 | 例 |
| ------------- | ------------- |------------- |
| PostalCode | 郵便番号 | 153-0064 |
| StateOrRegion | 都道府県名 | 東京都 |
| city | 市区町村 | 目黒区 |
| town | 町域  | 下目黒|
| streetNumber | 番地 |１丁目８−１ | 
| building | マンション・建物名 | アルコタワーアネックス  |