Find Geo Address
Zuletzt geändert: 01.08.2026 21:21

Übersicht

Find-GeoAddress #

ÜBERSICHT #

Geocoding vorwärts: Anschrift -> Koordinaten-Kandidaten.

SYNTAX #

Find-GeoAddress [[-Query] <string>] [[-Street] <string>] [[-Postcode] <string>] [[-City] <string>]
    [[-CountryCode] <string>] [[-Limit] <int>] [[-Config] <hashtable>] [<CommonParameters>]

BESCHREIBUNG #

Freitext oder strukturierte Anschrift wird über die Geocoding-Kette (Resolve-GeoProvider: Nominatim, dann Photon) in Kandidaten mit Koordinate, zerlegter Anschrift und Trefferwert aufgelöst. Photon kennt keine strukturierte Suche - die Teile werden dort zu einem Freitext zusammengesetzt.

Rückgabe: @{ provider; cached = $false; results = @(…) } - je Kandidat lat, lon, label, street, houseNumber, postcode, city, countryCode, score (Photon liefert keinen Trefferwert, dort $null). cached ist hier immer $false; den Cache führt die REST-Fassade - zusammen mit der Pflicht-Drossel für den öffentlichen Nominatim (höchstens 1 Anfrage/s).

PARAMETER #

-Query #

Type: string

Freitext-Anschrift. Alternativ die strukturierten Felder.

-Street #

Type: string

Straße mit Hausnummer (strukturierte Suche).

-Postcode #

Type: string

Postleitzahl (strukturierte Suche).

-City #

Type: string

Ort (strukturierte Suche).

-CountryCode #

Type: string

ISO2-Länderkennung, z.B. DE (strukturierte Suche).

-Limit #

Type: int
Default: 5

Höchstzahl Kandidaten, Default 5.

-Config #

Type: hashtable
Default: @{}

Provider-Konfiguration (siehe Resolve-GeoProvider); keine Registry- Lesung im Kern.

BEISPIELE #

Find-GeoAddress -Query 'Goethestraße 12, Frankfurt' -Config @{}
Find-GeoAddress -Street 'Goethestraße 12' -Postcode '60313' -City 'Frankfurt am Main' -CountryCode DE