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