Wenn Sie die Address Validation API verwenden, können Sie anfordern, 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 aus einer anderen Sprache empfangen wird. Beispiele:
- Ihr Unternehmen kann Versandanfragen aus der ganzen Welt ausführen und alle Adressen mit englischen und englischen lateinischen Zeichen standardisieren.
- Möglicherweise übernimmt Ihr Unternehmen Lieferungen in ein und aus einem Land, das eine andere Sprache als die angegebene Sprache verwendet.
Adresse auf Englisch zurückgeben
Wenn Sie eine Adressvalidierung 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 bei der Bestätigung der Adresse für das Prado-Museum Komponenten in englischer Sprache angefordert:
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'
Als 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 Adresse in der lokalen Sprache wird so gut wie möglich ins Englische konvertiert.
Das Feld englishLatinAddress verwendet dasselbe Address-Protokoll wie das Feld address, mit folgenden Ausnahmen:
- Kein
ConfirmationLevel-Feld - Kein Feld
unconfirmedComponentTypes
Funktionsweise der Adresskonvertierung
Die Address Validation API wendet die englische Konvertierung 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 aussehen würde.
Der Dienst verwendet für jede für die englische Konvertierung ausgewertete Komponente den in den folgenden Abschnitten beschriebenen Prozess.
Nach Möglichkeit vollständig übersetztes Englisch
Für einige Adresskomponenten steht möglicherweise eine vollständig übersetzte Version zur Verfügung.
Das spanische Land España wird beispielsweise mit Spain übersetzt. In diesem Fall verwendet der Dienst die englische Version. Dies trifft normalerweise auf größere Adresskomponenten wie country und administrative_area_level_1 zu.
Die lokale Sprache wird in lateinischer Schrift verwendet, wenn Englisch nicht verfügbar ist.
Lateinisch bedeutet, dass die lokale Sprache durch Transkription in die lateinische Schrift konvertiert 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 auf Englisch basieren.
Zum Beispiel wird
Calle DueñaszuCalle Duenas, wobei ñ durch n ersetzt wird. - Wenn für die lokale Sprache der Adresse kein lateinischer Zeichensatz verwendet wird und kein englisches Äquivalent für die Adresskomponente vorhanden ist, verwendet der Dienst eine lateinisierte Version der lokalen Sprache, falls verfügbar.
Beispiel: Bei einer Umwandlung in Japan wird die Japanische romanisierung zurückgegeben.
Alle nicht englischen und nicht lateinischen Zeichen werden durch englischbasierte lateinische Zeichen ersetzt. Beispiel: 3丁 wird zu 3-chome.
- Hinweis: Japanisch ist noch nicht für die Vorschau aktiviert.
- Wenn keine lateinische Version der Sprache verfügbar ist, werden die Komponenten in der lokalen Sprache zurückgegeben.
Ersetzt lateinische Zeichen außerhalb des Englischen.
Alle lateinischen Zeichen, die nicht im Englischen sind, werden durch ihr äquivalentes englisches Zeichen ersetzt. Beispielsweise würde jedes der folgenden Zeichen durch das Zeichen „o“ ersetzt werden: ð, ò, ó, ô, õ, ö, ø, ō, {8/}, ő, ơ, ṍ, ṏ, ṑ, ṓ, Verschieben, ỏ, ố, ồ, ử, ỗ, ộ, ộ. Beispiele:
Calle de Ruiz de Alarcón wird zu Calle de Ruiz de Alarcon
Beispiel für Adress-Conversion
Das folgende Beispiel zeigt eine Validierungsantwort für eine Anfrage für den Palacio de las Dueñas in Spanien, wobei englishLatinAddress fett hervorgehoben ist. Bei dieser Anfrage wurde das Feld returnEnglishLatinAddress im Parameter languageOptions 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"