Adressen ins Englische umwandeln

Wenn Sie die Address Validation API verwenden, können Sie anfordern, dass eine Validierungsantwort auch die in Englisch umgewandelte Adresse zurückgibt. Verwenden Sie diese Funktion, wenn Ihr System Adressinformationen in englischsprachigen lateinischen Zeichen bereitstellen muss, wenn eine Adresse in einer nicht englischen Sprache empfangen wird. Beispiel:

  • Ihr Unternehmen kann Versandanfragen aus der ganzen Welt bearbeiten und zur Standardisierung aller Adressen englische und englischsprachige lateinische Zeichen verwenden.
  • Ihr Unternehmen kann Lieferungen in und aus einem Land verarbeiten, in dem eine andere Sprache als die Sprache der angegebenen Adresse verwendet wird.

Adresse auf Englisch zurückgeben

Wenn Sie eine Adressvalidierung mit enthaltenen englischsprachigen Komponenten anfordern möchten, fügen Sie dem Text der Validierungsanfrage Folgendes hinzu:

languageOptions: { returnEnglishLatinAddress: "true" }.

Im folgenden Beispiel werden englischsprachige Komponenten angefordert, während die Adresse beim Prado-Museum überprü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 für die Adressumwandlung. Jede Komponente der zurückgegebenen Adresse in der lokalen Sprache 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 Protokoll Address wie das Feld address, mit folgenden Ausnahmen:

Funktionsweise der Adressumwandlung

Über die Address Validation API wird die englische Konvertierung auf jede Komponente der Adresse angewendet. 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 englische Umwandlung für die Adresse Calle Dueñas, 5, 41003 Sevilla, España aussehen würde.

Übersetzte Adresskomponenten, einschließlich Route, Land und Ort

Für jede Komponente, für die eine Konvertierung in Englisch ausgewertet wurde, verwendet der Dienst den in den folgenden Abschnitten beschriebenen Prozess.

Nach Möglichkeit wird eine vollständige Übersetzung des Englischen verwendet.

Für einige Adresskomponenten steht möglicherweise eine vollständig übersetzte Version zur Verfügung. Beispielsweise wird das spanische Land España mit Spain übersetzt. In diesem Fall verwendet der Dienst die englische Version. Das ist in der Regel bei größeren Adresskomponenten wie country und administrative_area_level_1 der Fall.

Wenn kein Englisch verfügbar ist, wird die lokale Sprache verwendet.

Lateinisch bedeutet, dass die lokale Sprache mithilfe von Transkriptionen in die lateinische Schrift konvertiert wird.

  • Wenn in der lokalen Sprache der Adresse ein lateinischer Zeichensatz verwendet wird und für die Adresskomponente keine englische Entsprechung vorhanden ist, ersetzt der Dienst Zeichen aus der lokalen Sprache, die nicht auf Englisch basieren. Beispiel: Calle Dueñas wird zu Calle Duenas, wobei ñ durch n ersetzt wird.
  • Wenn für die lokale Sprache der Adresse kein lateinischer Zeichensatz verwendet wird und für die Adresskomponente kein englisches Äquivalent vorhanden ist, verwendet der Dienst eine lateinamerikanische Version der lokalen Sprache, falls verfügbar. Eine japanische Konvertierung gibt beispielsweise die Umschrift des Japanischen zurück. Alle nicht englischen und nichtlateinischen Zeichen werden durch lateinische Zeichen ersetzt, die auf Englisch basieren. Zum Beispiel: 3丁 wird zu 3-chome.
    • Hinweis: Japanisch ist für die Vorschau noch nicht aktiviert.
  • Wenn keine lateinische Version der Sprache verfügbar ist, werden die Komponenten in der lokalen Sprache zurückgegeben.

Ersetzt lateinische Zeichen, die nicht im Englischen verwendet werden

Alle lateinischen Zeichen, die nicht auf Englisch sind, werden durch die entsprechenden englischen Zeichen ersetzt. So wird beispielsweise jedes der folgenden Zeichen durch das Zeichen „o“ ersetzt: ð, ò, ó, ô, õ, ö, ø, ō, footnote, ő, ơ, ṍ, ṏ, ṑ, ṓ, ử, ỏ, ố, ồ, ợ, ỗ, ờ, ờ, ợ, ỗ Beispiel:

Calle de Ruiz de Alarcón wird zu Calle de Ruiz de Alarcon.

Beispiel für Adressumwandlung

Das folgende Beispiel zeigt eine Validierungsantwort auf eine Anfrage für den Palacio de las Dueñas in Spanien. englishLatinAddress ist fett formatiert. 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"

Supportoptionen für Vorabversionen

Google bietet keinen Support für Vorabversionen, Funktionen oder Funktionen der Dienste. Anfragen in diesen Entwicklungsphasen werden jedoch von Fall zu Fall geprüft.

Beachten Sie diese Empfehlungen für pre-GA-Versionen:

  • Pre-GA-Funktionen sind nicht durch das SLA für die Google Maps Platform abgedeckt.

  • Verwenden Sie Fallback-Mechanismen, insbesondere wenn Sie eine Pre-GA-Funktion in einer Produktionsumgebung verwenden. Beispiele für Fallback-Situationen: Kontingentüberschreitung, unerwartete Antwortcodes und Latenz oder unerwartete Antworten im Vergleich zum bestehenden Verhalten.

Über den Issue Tracker können Sie neue Funktionen oder Änderungen an vorhandenen Funktionen vorschlagen. Achten Sie darauf, dass Sie Folgendes in Ihrer Anfrage angeben:

  • Beschreiben Sie die Funktion oder das Verhalten, die bzw. das hinzugefügt werden soll, und erläutern Sie, warum dies Ihrer Meinung nach wichtig ist.

  • Wenn möglich, geben Sie konkrete Details zu Ihrem Anwendungsfall und die neuen Möglichkeiten an, die das Feature bietet.

Für dieses Feedback oder andere Fragen zu den Funktionen senden Sie eine E-Mail an die Address Validation Hotline: address-validation-hotline@google.com.