Wenn Sie die Address Validation API verwenden, können Sie beantragen, dass eine Validierungsantwort auch die ins Englische konvertierte Adresse zurückgibt. Verwenden Sie diese Funktion, wenn Ihr System Adressinformationen in englischsprachigen lateinischen Zeichen bereitstellen muss, wenn eine Adresse in einer anderen Sprache als Englisch empfangen wird. Beispiele:
- Ihr Unternehmen kann Versandanfragen aus der ganzen Welt abwickeln und englische und englischsprachige lateinische Zeichen verwenden, um alle Adressen zu standardisieren.
- Möglicherweise wickelt Ihr Unternehmen Lieferungen in und aus einem Land ab, in dem eine andere Sprache als die in der angegebenen Adresse angegebene Sprache verwendet wird.
Adresse auf Englisch zurückgeben
Wenn Sie eine Adressüberprüfung mit enthaltenen englischsprachigen Komponenten anfordern möchten, fügen Sie Folgendes in den Text der Überprüfungsanfrage ein:
languageOptions: { returnEnglishLatinAddress: "true" }.
Im folgenden Beispiel werden englischsprachige Komponenten angefordert, während die Adresse für das Prado-Museum geprüft wird:
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'
In der Antwort wird die englische Adresse im Feld englishLatinAddress
zurückgegeben. Weitere Informationen finden Sie unten im Abschnitt Beispiel zur Adresskonvertierung. Jede Komponente der zurückgegebenen lokalen Adresse wird so gut wie möglich ins Englische konvertiert. Die konvertierte Adresse kann nicht als Eingabe für die API wiederverwendet werden.
Das Feld englishLatinAddress
verwendet dasselbe Address-Protokoll wie das Feld address
, mit folgenden Ausnahmen:
- Kein Feld
ConfirmationLevel
- Kein Feld
unconfirmedComponentTypes
Funktionsweise der Adressumwandlung
Die Address Validation API wendet die englische Umwandlung auf jede Komponente der Adresse an. Das bedeutet, dass administrative_area
, locality
und andere Komponenten der Adresse einzeln behandelt werden. Eine Liste der Adresskomponenten finden Sie in der Referenzdokumentation unter AddressComponent.
Das folgende Diagramm zeigt, wie die Umwandlung in englischer Sprache für die Adresse Calle Dueñas, 5, 41003 Sevilla, España dargestellt würde.
Für jede Komponente, die für die englische Konvertierung ausgewertet wird, verwendet der Dienst den in den folgenden Abschnitten beschriebenen Prozess.
Wenn möglich, wird vollständig übersetztes Englisch verwendet.
Für einige Adresskomponenten ist möglicherweise eine vollständig übersetzte Version verfügbar.
Das spanische Land España
wird beispielsweise in Spain
übersetzt. In diesem Fall verwendet der Dienst die englische Version. Das ist normalerweise der Fall für größere Adresskomponenten wie country
und administrative_area_level_1
.
Wenn Englisch nicht verfügbar ist, wird die lokale Sprache verwendet.
Lateinische Umwandlung bedeutet, dass die lokale Sprache mithilfe der Transkription in die lateinische Schrift umgewandelt wird.
- Wenn für die lokale Sprache der Adresse ein lateinischer Zeichensatz verwendet wird und für die Adresskomponente kein englisches Äquivalent vorhanden ist, ersetzt der Dienst Zeichen aus der lokalen Sprache, die nicht englisch sind.
Beispielsweise wird
Calle Dueñas
zuCalle Duenas
, wobei ñ durch n ersetzt wird. - Wenn die lokale Sprache der Adresse keinen lateinischen Zeichensatz verwendet und kein englisches Äquivalent für die Adresskomponente vorhanden ist, verwendet der Dienst eine lateinisierte Version der lokalen Sprache, falls verfügbar.
Eine japanische Conversion gibt beispielsweise die romanische Umschrift auf Japanisch zurück.
Alle nicht englischen und nicht lateinischen Zeichen werden durch englischbasierte lateinische Zeichen ersetzt. Beispiel: 3丁 wird zu 3-chome.
- Hinweis: Japanisch ist für die Vorabversion noch nicht aktiviert.
- Wenn keine lateinamerikanische Version der Sprache verfügbar ist, werden die Komponenten in der lokalen Sprache zurückgegeben.
Ersetzt lateinische Zeichen nicht auf Englisch
Alle lateinischen Zeichen, die nicht im Englischen stehen, werden durch ihre englischen Zeichen ersetzt. Beispielsweise würde jedes der folgenden Zeichen durch das Zeichen „o“ ersetzt werden: ð, ò, ó, ô, õ, ö, ø, ō, REQUEST, ő, ơ, ṍ, ṏ, ṑ, ṓ, Hat, ỏ, ố, ồ, ơ, ơ, ơ, ơ, ơ, ộ Beispiele:
Calle de Ruiz de Alarcón wird zu Calle de Ruiz de Alarcon
Beispiel für eine Adresskonvertierung
Das folgende Beispiel zeigt eine Validierungsantwort aus einer Anfrage für den Palacio de las Dueñas in Spanien, wobei englishLatinAddress
fett hervorgehoben ist. Für diese Anfrage wurde das Feld returnEnglishLatinAddress
im Parameter languageOptions
in der Eingabe verwendet.
"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"