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"
プレビュー リリースのサポート オプション
Google は本サービスのプレビュー版のバージョン、機能、機能をサポートしていませんが、開発段階のリクエストは状況に応じて検討します。
pre-GA バージョンについては、次の推奨事項を使用してください。
pre-GA の機能は Google Maps Platform SLA の対象外です。
特に本番環境で pre-GA の機能を使用する場合は、フォールバック メカニズムを使用します。フォールバックの状況の例としては、割り当て超過、予期しないレスポンス コードとレイテンシ、既存の動作と比較した場合の予期しないレスポンスなどがあります。
Issue Tracker を使用して、新機能をリクエストしたり、既存の機能の変更を提案したりできます。リクエストには必ず次の情報を含めてください。
追加を希望する機能や動作、およびそれが重要だと思う理由を説明してください。
可能であれば、ユースケースに関する具体的な詳細と、この機能によって実現する新しい機会を含めてください。
このフィードバックや機能に関するその他のご質問については、Address Validation Hotline(address-validation-hotline@google.com)までメールをお送りください。