Portugal (PRT)

Dieser Abschnitt definiert die unterstützten Geocoding-Datasets, Vorgänge sowie Eingabe- und Ausgabefeldinformationen für Portugal.

Unterstützte Geocoding-Datasets

Die folgende Tabelle führt die unterstützten Geocoding-Datasets mit den verfügbaren Geocoding-Ebenen für Portugal auf.

Anmerkung: Benutzerwörterbücher werden unterstützt.
Geocoding-Dataset Ortsmittelpunkt Vorort-/Dorfmittelpunkt PLZ-Mittelpunkt Straßenmittelpunkt Interpolierte Straßenanschrift Adresse auf Punktebene Point of Interest
HERE Portugiesisch Ja Ja Ja Ja Ja Ja Nein
TomTom Portugiesisch Ja Ja Ja Ja Nein Nein Nein

Unterstützte Vorgänge

Die folgenden Vorgänge werden für Portugal unterstützt:
  • Geocoding: Dabei werden eine oder mehrere Adressen als Eingabe genutzt und es werden Breitengrad/Längengrad-Koordinaten sowie weitere Informationen zurückgegeben.
  • Reverse Geocoding: Dabei werden eine oder mehrere Breitengrad/Längengrad-Koordinaten als Eingabe genutzt und es wird die Adresse des Standorts zurückgegeben.
  • Interactive Geocoding: Gibt potenzielle Kandidaten mit Übereinstimmung zurück, wenn die Adresse eingegeben wird.
  • Globale Schlüsselsuche: Gibt Geocode-Kandidaten zurück, wenn ein eindeutiger Schlüssel als Eingabe angegeben wird. Nur „USA MLD“- und „AUS GNAF“-Daten.

Eingabefelder

Die Eingabeadresse kann einige oder alle der folgenden Adresselemente enthalten.

Parameter Typ Beschreibung
placeName Zeichenfolge Gibt den Gebäudenamen, den Ortsnamen, den Point of Interest (POI), den Unternehmens- oder Firmennamen an, der mit der Eingabeadresse verknüpft ist. Optional:
mainAddress Zeichenfolge Einzeilige Eingabe: Wenn kein weiteres Adressfeld ausgefüllt wird, wird der Eintrag mainAddress als einzeilige Eingabe verarbeitet. Eine einzeilige Eingabe kann aus mehreren Eingabeadressfeldern bestehen. Diese müssen in der typischen Adressreihenfolge des Landes eingegeben werden. Weitere Informationen finden Sie im unteren Abschnitt „Einzeilige Eingabe“.

Straßenanschrift: Wenn die Komponenten der Postanschrift (City, PostalCode usw.) separat oder im Feld „lastLine“ angegeben werden, wird der Inhalt von mainAddress als Teil der Straßenanschrift verarbeitet und kann den Namen eines Unternehmens, die Hausnummer, Gebäudenamen und Straßennamen enthalten. Optional:

Straßenkreuzungseingabe: Um eine Kreuzung einzugeben, geben Sie die beiden Straßennamen ein, und trennen Sie sie anhand eines doppelten kaufmännischen Und-Zeichens (&&).
lastLine Zeichenfolge Die letzte Zeile der Adresse. Optional: Beispiel:

Rua Miguel Bombarda 49
2775-153 Parede
areaName1 Zeichenfolge Gibt die Region an. Optional:
areaName2 Zeichenfolge Nicht verwendet.
areaName3 Zeichenfolge Gibt den Ort oder die Stadt an. Dies kann auch der Stadt-Alias sein. Lisbon, Lisbonne, Lissabon und Lisbona sind beispielsweise alles Aliase für Lisboa. Optional:
areaName4 Zeichenfolge Gibt die Lokalität an. Optional:
postalCode Zeichenfolge Portugal besitzt eine vierstellige Postleitzahl, die mit einer Ziffer zwischen 1 und 9 beginnt. Vor nicht allzu langer Zeit wurde in Portugal eine siebenstellige Postleitzahl eingeführt, bei der auf die ersten vier Ziffern ein Bindestrich und drei zusätzliche Ziffern folgen. Der Geocoder ignoriert die zusätzlichen drei Ziffern und gibt die vierstellige Postleitzahl zurück. Optional:
country Zeichenfolge Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für Portugal lautet PRT. Für Forward Geocoding erforderlich.

Adressenrichtlinien für Portugal

Folgen Sie diesen Vorschlägen, damit Ihre Eingabeadressdaten das bestmögliche Format für optimale Vergleichs- und Geocoding-Vorgänge aufweisen. Weitere Informationen über Adressen in Portugal finden Sie auf der Website der portugiesischen Post CTT: www.ctt.pt.

  • Pflichtfelder: Adressen müssen entweder einen Ort oder eine Postleitzahl enthalten.
  • Durchfahrtstypen: Durchfahrtstypen und ihre allgemeinen Abkürzungen werden erkannt und vollständig in Eingabeadressen unterstützt.
  • Gängige Wörter und Abkürzungen: Der Geocoder erkennt gängige Wörter, Richtungsangaben, Hausnummernindikatoren und Abkürzungen, die in Adressen verwendet werden, und geocodiert diese Adressen erfolgreich.
  • Nummern, numerische Entsprechungen und Ordnungszahlen: Nummerierte Straßen werden den benannten Entsprechungen zugeordnet. Ordnungszahlen werden ebenfalls in Eingabeadressen erkannt.
  • Adresspunktdaten: Die PRT HERE Points-Datenbank enthält Adresspunktdaten. Adresspunkt-Kandidaten geben den Ergebniscode S8 zurück.

Einzeilige Eingabe

Anstatt jede Adresskomponente in separate Felder einzugeben, können Sie die gesamte Adresse in das Eingabefeld mainAddress eingeben, wobei die Reihenfolge der Adresselemente folgendermaßen aussieht:

[street_info][address_number][postal_code][area]

Wo:
  • [street_info] besteht aus dem Straßennamen, dem Straßentyp und allen Informationen zu voran- und nachgestellten Richtungsangaben (z. B. Osten, Westen usw.). Optional:
  • [address_number] ist optional.
  • [postal_code] ist die Postleitzahl.
  • [area] ist nur der Ort oder der Ort mit ergänzenden Informationen, wie z. B. Bundesland, Kanton, Lokalität.
  • Es ist entweder [area] oder [postal_code] erforderlich.

Geben Sie ein Komma zwischen den Straßeninformationen und den Daten der letzten Adresszeile ein, um optimale Ergebnisse zu erzielen.

Benutzerdefinierte Optionen

Die folgende Tabelle führt die für Portugal spezifischen Optionen auf. Diese benutzerdefinierten Felder gelten für den Geocoding-Vorgang und sind optionale Eingabeparameter. Informationen zu den für alle Länder verfügbaren Standardoptionen und ihren Definitionen finden Sie in den Kapiteln über . Geocode-Dienst und Reverse Geocode-Dienst.

Name der Option Beschreibung
USE_ADDRESS_POINT_INTERPOLATION Bei einer Einstellung auf true wird die Adresspunktinterpolation aktiviert. Standardeinstellung = false. Nur beim Forward Geocoding unterstützt.
Anmerkung: Bei der Adresspunktinterpolation muss ein Geocoding-Dataset auf Punktebene installiert sein.
USE_CENTERLINE_OFFSET Bei einer Einstellung auf true, wird der Versatz von der Mittellinie für Punktadressen berechnet. Standardeinstellung = false. Nur beim Forward Geocoding unterstützt.
Anmerkung: Bei der Mittellinienfunktion muss ein Geocoding-Dataset auf Punktebene installiert sein.
Bei einer Mittellinienpunktübereinstimmung wird ein Ergebniscode zurückgegeben, der mit SC beginnt.
CENTERLINE_OFFSET Wenn USE_CENTERLINE_OFFSET aktiviert ist, gibt dieser Wert die Versatzentfernung des Punktes von der Mittellinie an. Standardeinstellung = 0. Wird nur beim Forward Geocoding unterstützt.
CENTERLINE_OFFSET_UNIT Wenn USE_CENTERLINE_OFFSET aktiviert ist, gibt dieser Wert den Einheitstyp für den Versatz von der Mittellinie an. Gültige Werte = Fuß, Meter. Standardeinstellung = Meter. Nur beim Forward Geocoding unterstützt.

Ausgabefelder für

Die folgende Tabelle führt die Adressfelder auf, die für einen in Portugal befindlichen Kandidaten zurückgegeben werden.

Anmerkung: Die Feldwerte placeName, addressNumber, unitType und unitValue werden nur zurückgegeben, wenn ein Geocoding-Dataset installiert ist, das die Interpolation von Straßenanschriften unterstützt.
Feldname Beschreibung
mainAddressLine Die Straßenanschrift, die den Unternehmensnamen, die Hausnummer, Gebäudenamen und Straßennamen enthält.
addressLastLine Die letzte Zeile der Adresse.
placeName Der Gebäudename, Ortsname, Point of Interest (POI), Unternehmens- oder Firmenname, der mit der Adresse verknüpft ist.
areaName1 Die Region.
areaName2 Nicht verwendet.
areaName3 Der Ort oder die Stadt.
areaName4 Die Lokalität.
postCode1 Die ersten vier Ziffern der Postleitzahl.
postCode2 Nicht verwendet.
country Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für Portugal lautet PRT.
addressNumber Die Adressnummer.
streetName Der Straßen- oder Wegname.
unitType Der Einheitstyp wie APT, STE usw.
unitValue Der Wert/die Nummer der Einheit, z. B. „3B“.
customFields Portugal besitzt keine benutzerdefinierten Ausgabefelder.