Address Validation API を使用する場合は、英語に変換された住所も検証レスポンスで返すようにリクエストできます。英語以外の言語の住所を受信するときに、英語ベースのラテン文字で住所情報を提供する必要がある場合は、この機能を使用します。次の例をご覧ください。
- 会社では、世界中からの配送リクエストに対応し、英語と英語ベースのラテン文字を使用してすべての住所を標準化する場合があります。
- ビジネスで、指定された住所の言語とは異なる言語を使用する国との間の配送を処理する場合があります。
住所を英語で返品する方法
含まれている英語対応のコンポーネントを使用して住所検証をリクエストするには、検証リクエストの本文に以下を追加します。
languageOptions: { returnEnglishLatinAddress: "true" }.
次の例では、プラド美術館の住所を確認しながら、英語ベースのコンポーネントをリクエストしています。
curl -X POST -d '{ "regionCode" : ["ES"], "addressLines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"], "languageOptions": {returnEnglishLatinAddress: true} }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: API_KEY' \ 'https://addressvalidation.googleapis.com/v1:validateAddress'
レスポンスの englishLatinAddress
フィールドに英語の住所が返されます。詳しくは、以下の住所変換の例をご覧ください。返された各言語の住所は、可能な限り英語に変換されます。変換された住所を API への入力として再利用することはできません。
englishLatinAddress
フィールドでは、address
フィールドと同じ Address プロトコルを使用します。ただし、次の例外があります。
ConfirmationLevel
フィールドなしunconfirmedComponentTypes
フィールドなし
住所変換の仕組み
Address Validation API は、住所の各構成要素に英語変換を適用します。つまり、住所の administrative_area
、locality
、その他のコンポーネントは個別に処理されます。住所コンポーネントのリストについては、リファレンス ドキュメントの AddressComponent をご覧ください。
次の図は、住所 Calle Dueñas, 5, 41003 Sevilla, España を英語に変換した場合を示しています。
英語変換について評価されたコンポーネントごとに、サービスは次のセクションで説明するプロセスを使用します。
可能な限り、完全翻訳の英語を使用している
住所コンポーネントによっては、完全翻訳版が利用可能な場合があります。たとえば、スペインの国「España
」は「Spain
」と翻訳されます。その場合、英語版が使用されます。これは通常、country
や administrative_area_level_1
などのより大きな住所コンポーネントに該当します。
英語が利用できない場合は、現地の言語のラテン語化を使用します。
ラテン化とは、音声文字変換によってローカル言語がラテン文字に変換されることを意味します。
- 住所のローカル言語がラテン文字セットを使用していて、住所コンポーネントに英語の相当する文字セットが存在しない場合、サービスはそのローカル言語が英語ベースではない文字を置き換えます。たとえば、
Calle Dueñas
はCalle Duenas
になります。ここで、ñ は n に置き換えられます。 - 住所のローカル言語がラテンベースの文字セットを使用しておらず、住所コンポーネントに英語の同等の文字セットが存在しない場合、サービスはローカル言語のラテン化版を使用します(使用可能な場合)。たとえば、日本語に変換した場合、日本語のローマ字化が返されます。英語以外のラテン文字以外の文字は、英語ベースのラテン文字に置き換えられます。たとえば、「3 丁目」は「3-chome」になります。
- なお、日本語はプレビュー版ではまだご利用いただけません。
- 言語のラテン化版を使用できない場合は、コンポーネントはローカル言語で返されます。
英語以外のラテン文字を置き換えます
英語以外のラテン文字は、対応する英語文字に置き換えられます。たとえば、次の文字は「o」に置き換えられます。次の例をご覧ください。
Calle de Ruiz de Alarcón が Calle de Ruiz de Alarcon になる
住所変換の例
次の例は、スペインの Palacio de las Dueñas へのリクエストからの検証レスポンスであり、englishLatinAddress
は太字で表示されています。このリクエストでは、入力の languageOptions
パラメータで returnEnglishLatinAddress
フィールドが使用されています。
"result": { "verdict": { "inputGranularity": "PREMISE", "validationGranularity": "PREMISE", "geocodeGranularity": "PREMISE", "addressComplete": true, "hasInferredComponents": true }, "address": { "formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España", "postalAddress": { "regionCode": "ES", "languageCode": "es", "postalCode": "41003", "administrativeArea": "Sevilla", "locality": "Sevilla", "addressLines": [ "C. Dueñas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Dueñas", "languageCode": "es" }, "componentType": "route", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "41003" }, "componentType": "postal_code", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "locality", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "España", "languageCode": "es" }, "componentType": "country", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "administrative_area_level_2", "confirmationLevel": "CONFIRMED", "inferred": true } ] }, "geocode": { "location": { "latitude": 37.394849, "longitude": -5.9893604 }, "plusCode": { "globalCode": "8C9P92V6+W7" }, "bounds": { "low": { "latitude": 37.3948098, "longitude": -5.9894249 }, "high": { "latitude": 37.3948882, "longitude": -5.9893025 } }, "featureSizeMeters": 7.174035, "placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI", "placeTypes": [ "premise" ] }, "metadata": { "business": true, "residential": false }, "englishLatinAddress": { "formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain", "postalAddress": { "regionCode": "ES", "languageCode": "en", "postalCode": "41003", "administrativeArea": "Seville", "locality": "Seville", "addressLines": [ "C. Duenas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Duenas", "languageCode": "es" }, "componentType": "route", }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", }, { "componentName": { "text": "41003" }, "componentType": "postal_code", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "locality", }, { "componentName": { "text": "Spain", "languageCode": "en" }, "componentType": "country", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "administrative_area_level_2", "inferred": true } ] } }, "responseId": "e874d263-7d0d-413f-9213-119a784765ed"