Global Address Validation

Global Address Validation は、高度な住所の正規化および検証の機能を提供します。Global Address Validation は、複数のデータ ソースからのデータを単一の Global Addressing Validation データベースに統合して、可能な限り多くの正確な国際住所データを提供します。

Global Address Validation は、各入力住所を分析し、該当する国の Global Addressing データベースと照合します。必要に応じて Global Address Validation は、その国の郵便規格に従って住所を修正し、書式を整えます。

標準住所出力は、宛名ラベルに表記される住所に対応する住所行で構成されます。都市、州または省、郵便番号などのデータも、標準住所出力に含まれます。

Global Address Validation は Global Addressing モジュールの一部です。

リソース URL

JSON エンドポイント:

http://server:port/rest/GlobalAddressValidation/result.json

XML エンドポイント:

http://server:port/rest/GlobalAddressValidation/result.xml

JSON 応答の例

次の例では、JSON 応答を要求します。

http://server:8080/rest/GlobalAddressValidation/result.json?​Data.AddressLine1=​103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003 &Data.Country=AUS

この要求から次のような JSON が返されます。

{"output_port": [{
   "AddressLine1": "103-113 Stanley Street",
   "AddressBlock1": "103-113 Stanley Street",
   "AddressBlock2": "West Melbourne VIC 3003",
   "City": "West Melbourne",
   "StateProvince": "VIC",
   "PostalCode": "3003",
   "Country": "Australia",
   "PrecisionCode": "S8HPNTSCZG",
   "ProcessedBy": "GAM",
   "MultimatchCount": "1",
   "HouseNumber": "103-113",
   "StreetName": "Stanley",
   "StreetType": "Street",
   "Confidence": "92",
   "Principality": "VIC",
   "MatchOnAllStreetFields": "true",
   "MatchOnStreetDirectional": "true",
   "City.Matched": "true",
   "CitySubdivision.Matched": "true",
   "StateProvince.Matched": "false",
   "StateProvinceSubdivision.Matched": "true",
   "StreetName.Matched": "true",
   "StreetType.Matched": "true",
   "Firmname.Matched": "true",
   "Housenumber.Matched": "true",
   "Postalcode.Matched": "true",
   "user_fields": []
}]}

XML 応答の例

次の例では、XML 応答を要求します。

http://server:8080/rest/GlobalAddressValidation/result.xml?Data.AddressLine1=103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003&Data.Country=AUS

この要求から次のような XML が返されます。

<xml.GlobalAddressValidationResponse xmlns="http://www.pb.com/spectrum/services/GlobalAddressValidation">
<output_port>
    <Row>
        <AddressLine1>103-113 Stanley Street</AddressLine1>
        <AddressBlock1>103-113 Stanley Street</AddressBlock1>
        <AddressBlock2>West Melbourne VIC 3003</AddressBlock2>
        <City>West Melbourne</City>
        <StateProvince>VIC</StateProvince>
        <PostalCode>3003</PostalCode>
        <Country>Australia</Country>
        <PrecisionCode>S8HPNTSCZG</PrecisionCode>
        <ProcessedBy>GAM</ProcessedBy>
        <MultimatchCount>1</MultimatchCount>
        <HouseNumber>103-113</HouseNumber>
        <StreetName>Stanley</StreetName>
        <StreetType>Street</StreetType>
        <Confidence>92</Confidence>
        <Principality>VIC</Principality>
        <MatchOnAllStreetFields>true</MatchOnAllStreetFields>
        <MatchOnStreetDirectional>true</MatchOnStreetDirectional>
        <City.Matched>true</City.Matched>
        <CitySubdivision.Matched>true</CitySubdivision.Matched>
        <StateProvince.Matched>false</StateProvince.Matched>
        <StateProvinceSubdivision.Matched>true
          </StateProvinceSubdivision.Matched>
        <StreetName.Matched>true</StreetName.Matched>
        <StreetType.Matched>true</StreetType.Matched>
        <Firmname.Matched>true</Firmname.Matched>
        <Housenumber.Matched>true</Housenumber.Matched>
        <Postalcode.Matched>true</Postalcode.Matched>
        <user_fields/>
    </Row>
 </output_port>
</xml.GlobalAddressValidationResponse>

JSON の例

http://server:8080/rest/GlobalAddressValidation/result.json

JSON POST リクエストの例:


{
"options":
{
      "Database_GAV":"JP_AU"
},
"input_port" : {
              "Input" : [
               {
       "AddressLine1": "103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003",
       "Country": "AUS"
      },
      {
       "AddressLine1": "103-114 STANLEY ST VICTORIA WEST MELBOURNE 3004",
       "Country": "AUS"
      }       
              ]
}
}

JSON POST レスポンスの例:

{
    "output_port": [
        {
            "AddressLine1": "103-113 Stanley Street",
            "AddressBlock1": "103-113 Stanley Street",
            "AddressBlock2": "West Melbourne VIC 3003",
            "City": "West Melbourne",
            "StateProvince": "VIC",
            "PostalCode": "3003",
            "Country": "Australia",
            "PrecisionCode": "S8HPNTSCZG",
            "ProcessedBy": "GAM",
            "MultimatchCount": "1",
            "HouseNumber": "103-113",
            "StreetName": "Stanley",
            "StreetType": "Street",
            "Confidence": "92",
            "Principality": "VIC",
            "MatchOnAllStreetFields": "true",
            "MatchOnStreetDirectional": "true",
            "City.Matched": "true",
            "CitySubdivision.Matched": "true",
            "StateProvince.Matched": "false",
            "StateProvinceSubdivision.Matched": "true",
            "StreetName.Matched": "true",
            "StreetType.Matched": "true",
            "Firmname.Matched": "true",
            "Housenumber.Matched": "true",
            "Postalcode.Matched": "true",
            "user_fields": []
        },
        {
            "AddressLine1": "103-114 Stanley Street",
            "AddressBlock1": "103-114 Stanley Street",
            "AddressBlock2": "West Melbourne VIC 3003",
            "City": "West Melbourne",
            "StateProvince": "VIC",
            "StateProvinceSubdivision": "Melbourne",
            "PostalCode": "3003",
            "Country": "Australia",
            "PrecisionCode": "S5HPNTSC-A",
            "ProcessedBy": "GAM",
            "MultimatchCount": "1",
            "HouseNumber": "103-114",
            "StreetName": "Stanley",
            "StreetType": "Street",
            "Confidence": "80",
            "Principality": "VIC",
            "MatchOnAllStreetFields": "true",
            "MatchOnStreetDirectional": "true",
            "City.Matched": "true",
            "CitySubdivision.Matched": "true",
            "StateProvince.Matched": "false",
            "StateProvinceSubdivision.Matched": "true",
            "StreetName.Matched": "true",
            "StreetType.Matched": "true",
            "Firmname.Matched": "true",
            "Housenumber.Matched": "true",
            "Postalcode.Matched": "false",
            "user_fields": []
        }
    ]
}

XML の例

http://server:8080/rest/GlobalAddressValidation/result.xml
XML POST リクエストの例:
<GlobalAddressValidationRequest xmlns:gav="http://www.pb.com/spectrum/services/GlobalAddressValidation">
<options>
	<Database_GAV>JP_AU</Database_GAV>
</options>	
<gav:input_port>
    <gav:Input>
         <gav:AddressLine1>103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003
         </gav:AddressLine1>
         <gav:Country>AUS</gav:Country>
         <gav:user_fields>
             <gav:user_field>
                 <gav:name>id</gav:name>
                 <gav:value>1</gav:value>
             </gav:user_field>
         </gav:user_fields>

     </gav:Input>
     <gav:Input>
          <gav:AddressLine1>103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003
          </gav:AddressLine1>
          <gav:Country>AUS</gav:Country>
          <gav:user_fields>
              <gav:user_field>
                  <gav:name>id</gav:name>
                  <gav:value>2</gav:value>
              </gav:user_field>
         </gav:user_fields>
     </gav:Input>
</gav:input_port>
</GlobalAddressValidationRequest>
XML POST レスポンスの例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xml.GlobalAddressValidationResponse xmlns="http://www.pb.com/spectrum/services/GlobalAddressValidation">
    <output_port>
        <Row>
            <AddressLine1>103-113 Stanley Street</AddressLine1>
            <AddressBlock1>103-113 Stanley Street</AddressBlock1>
            <AddressBlock2>West Melbourne VIC 3003</AddressBlock2>
            <City>West Melbourne</City>
            <StateProvince>VIC</StateProvince>
            <PostalCode>3003</PostalCode>
            <Country>Australia</Country>
            <PrecisionCode>S8HPNTSCZG</PrecisionCode>
            <ProcessedBy>GAM</ProcessedBy>
            <MultimatchCount>1</MultimatchCount>
            <HouseNumber>103-113</HouseNumber>
            <StreetName>Stanley</StreetName>
            <StreetType>Street</StreetType>
            <Confidence>92</Confidence>
            <Principality>VIC</Principality>
            <MatchOnAllStreetFields>true</MatchOnAllStreetFields>
            <MatchOnStreetDirectional>true</MatchOnStreetDirectional>
            <City.Matched>true</City.Matched>
            <CitySubdivision.Matched>true</CitySubdivision.Matched>
            <StateProvince.Matched>false</StateProvince.Matched>
            <StateProvinceSubdivision.Matched>true
            </StateProvinceSubdivision.Matched>
            <StreetName.Matched>true</StreetName.Matched>
            <StreetType.Matched>true</StreetType.Matched>
            <Firmname.Matched>true</Firmname.Matched>
            <Housenumber.Matched>true</Housenumber.Matched>
            <Postalcode.Matched>true</Postalcode.Matched>
            <user_fields>
                <user_field>
                    <name>id</name>
                    <value>1</value>
                </user_field>
            </user_fields>
        </Row>
        <Row>
            <AddressLine1>103-113 Stanley Street</AddressLine1>
            <AddressBlock1>103-113 Stanley Street</AddressBlock1>
            <AddressBlock2>West Melbourne VIC 3003</AddressBlock2>
            <City>West Melbourne</City>
            <StateProvince>VIC</StateProvince>
            <PostalCode>3003</PostalCode>
            <Country>Australia</Country>
            <PrecisionCode>S8HPNTSCZG</PrecisionCode>
            <ProcessedBy>GAM</ProcessedBy>
            <MultimatchCount>1</MultimatchCount>
            <HouseNumber>103-113</HouseNumber>
            <StreetName>Stanley</StreetName>
            <StreetType>Street</StreetType>
            <Confidence>92</Confidence>
            <Principality>VIC</Principality>
            <MatchOnAllStreetFields>true</MatchOnAllStreetFields>
            <MatchOnStreetDirectional>true</MatchOnStreetDirectional>
            <City.Matched>true</City.Matched>
            <CitySubdivision.Matched>true</CitySubdivision.Matched>
            <StateProvince.Matched>false</StateProvince.Matched>
            <StateProvinceSubdivision.Matched>true
            </StateProvinceSubdivision.Matched>
            <StreetName.Matched>true</StreetName.Matched>
            <StreetType.Matched>true</StreetType.Matched>
            <Firmname.Matched>true</Firmname.Matched>
            <Housenumber.Matched>true</Housenumber.Matched>
            <Postalcode.Matched>true</Postalcode.Matched>
            <user_fields>
                <user_field>
                    <name>id</name>
                    <value>2</value>
                </user_field>
            </user_fields>
        </Row>
    </output_port>
</xml.GlobalAddressValidationResponse>