GeoService (Version 1, 2022-1)
Siden opdateres automatisk til at afspejle koden. CodeFirst.
Denne service henter Geodata (longitude og latitude) ud fra postnummer og adresse, til at beregne afstanden melllem job og bopæl vha. DAWA og Googles web api.
Metoder
GeocodeStructuredAddress
Denne metode finder geocoordinaterne ud fra vejnavn, vejnummer og postnummer. Den er anderledes end GeocodeSimpleAdressData fordi den modtager et andet object.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GeocodeStructuredAddressRequest | GeocodeStructuredAddressRequestType |
| 1 | En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra. |
- StreetName | string | Length: 0-50 | 1 | Vejnavn. |
- StreetBuildingIdentifer | string | Pattern: ^([1-9][0-9]{0,2}[a-zA-Z]?)(-[1-9][0-9]{0,2}[a-zA-Z]?)?$ | 1 | Husnummer. |
- FloorIdentifier | string | Pattern: [1-9]|[1-9][0-9]|KL|ST|kl|st|k[2-9]|K[2-9] | 0 - 1 | Etagenummer. |
- SuiteIdentifier | string | Length: 0-4 | 0 - 1 | Dør angivelse, fx th. |
- PostCodeIdentifier | string |
| 1 | Postnummer. |
- CountryIdentificationCode | CountryIdentificationCodeType |
| 1 | Landekode. Skal være i formatet ISO 3166 standard, alpha 2. (Eks. DK eller SE). |
- - BaseType | _CountryIdentificationCodeType | Pattern: [a-z,A-Z]{2}|[a-z,A-Z]{3}|[0-9]{3}|[0-9]{4} | 1 | Dette er en støttetype til CountryIdentificationCodeType. Det regulære udtryk er et valg for de 4 forskellige regulære udtryk for de forskellige formater. ISO 3166 standard, alpha 2: [a-z,A-Z]{2}. Eksempel "DK" for Danmark. ISO 3166 standard, alpha 3: [a-z,A-Z]{3}. Eksempel "DKN" for Danmark. UN Statistics Divisions country codes: [0-9]{3}. Eksempel "208" for Danmark AuthorityCode from the Central Office of Civil Registration: [0-9]{4}. Eksempel "5100" for Danmark. |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GeocodeStructuredAddressResponse | GeocodeStructuredAddressResponseType |
| 1 | En return value som indeholder geokoderne og kvaliteten af dem. |
- GeoCoordinate | GeoCoordinateType |
| 1 | WGS84 koordinatpunkt. |
- - Latitude | double |
| 1 | WGS84 breddegrad som decimaltal. |
- - Longitude | double |
| 1 | WGS84 længdegrad som decimaltal. |
- GeoCoordinateQuality |
| 1 | Angiver kvaliteten på geokoordinaterne. |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
9260 | Service call timeout | Service call timeout |
9261 | Service is unavailable | Service is unavailable |
9262 | Geocoding was not possible | Geocoding was not possible |
9441 | The Dawa server is unavailable or failed to process the request | The Dawa server is unavailable or failed to process the request |
9442 | The Dawa server is unavailable due to too many calls - server is throttling down | The Dawa server is unavailable due to too many calls - server is throttling down |
GeocodeSimpleAddress
Denne metode finder geocoordinaterne ud fra vejnavn, vejnummer og postnummer
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GeocodeSimpleAddressRequest | GeocodeSimpleAddressRequestType |
| 1 | En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra. |
- StreetNameAndNumber | string | Length: 0-100 | 1 | Vejnavn og Husnummer. |
- PostCodeIdentifier | string |
| 1 | Postnummer. |
- CountryIdentificationCode | string |
| 0 - 1 | Landekode |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GeocodeSimpleAddressResponse | GeocodeSimpleAddressResponseType |
| 1 | En return value som indeholder geokoderne og kvaliteten af dem. |
- GeoCoordinate | GeoCoordinateType |
| 1 | Geocoordinater. |
- - Latitude | double |
| 1 | WGS84 breddegrad som decimaltal. |
- - Longitude | double |
| 1 | WGS84 længdegrad som decimaltal. |
- GeoCoordinateQuality |
| 1 | Kvalitet af geocoordinater. |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
9260 | Service call timeout | Service call timeout |
9261 | Service is unavailable | Service is unavailable |
9262 | Geocoding was not possible | Geocoding was not possible |
9441 | The Dawa server is unavailable or failed to process the request | The Dawa server is unavailable or failed to process the request |
9442 | The Dawa server is unavailable due to too many calls - server is throttling down | The Dawa server is unavailable due to too many calls - server is throttling down |
CalculateDailyTravelTimeFromHome
Metoden udregner rejsetiden med offentlig transport fra bopæl til arbejdsplads. Tur/retur.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CalculateDailyTravelTimeFromHomeRequest | CalculateDailyTravelTimeFromHomeRequestType |
| 1 | En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra. |
- PersonCivilRegistrationIdentifier | PersonCivilRegistrationIdentifierType | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Borgers CPR nummer. |
- GeoCoordinate | GeoCoordinateType |
| 1 | WGS84 koordinatpunkt. |
- - Latitude | double |
| 1 | WGS84 breddegrad som decimaltal. |
- - Longitude | double |
| 1 | WGS84 længdegrad som decimaltal. |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CalculateDailyTravelTimeFromHomeResponse | CalculateDailyTravelTimeFromHomeResponseType |
| 1 | En return value som indeholder afstanden i fugleflugt og rejse tiden med offentligtransport mellem de to afstande.. |
- DailyTravelTime | int |
| 0 - 1 | Forventet daglig rejsetid i minutter fra hjemmeadressen med offentlige transportmidler. |
- DistanceInMeters | int |
| 1 | Fugleflugtsafstand fra hjemmeadressen (en vejs). |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
9259 | Could not find home address geographic coordinates for person | Could not find home address geographic coordinates for person |
9260 | Service call timeout | Service call timeout |
9261 | Service is unavailable | Service is unavailable |
9263 | Either the startcoordinate or endCoordinate is not located i Denmark | Either the startcoordinate or endCoordinate is not located i Denmark |
CalculateDailyTravelTime
Metoden udregner rejsetiden med offentlig transport mellem to geopunkter. Tur/retur.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CalculateDailyTravelTimeRequest | CalculateDailyTravelTimeRequestType |
| 1 | En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra. |
- GeoCoordinateOrigin | GeoCoordinateType |
| 1 | WGS84 koordinatpunkt - Fra. |
- - Latitude | double |
| 1 | WGS84 breddegrad som decimaltal. |
- - Longitude | double |
| 1 | WGS84 længdegrad som decimaltal. |
- GeoCoordinateDestination | GeoCoordinateType |
| 1 | WGS84 koordinatpunkt - Til. |
- - Latitude | double |
| 1 | WGS84 breddegrad som decimaltal. |
- - Longitude | double |
| 1 | WGS84 længdegrad som decimaltal. |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CalculateDailyTravelTimeResponse | CalculateDailyTravelTimeResponseType |
| 1 | En return value som indeholder afstanden i fugleflugt og rejse tiden med offentligtransport mellem de to afstande.. |
- DailyTravelTime | int |
| 0 - 1 | Forventet daglig rejsetid i minutter fra hjemmeadressen med offentlige transportmidler. |
- DistanceInMeters | int |
| 1 | Fugleflugtsafstand fra hjemmeadressen (en vejs). |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
9259 | Could not find home address geographic coordinates for person | Could not find home address geographic coordinates for person |
9260 | Service call timeout | Service call timeout |
9261 | Service is unavailable | Service is unavailable |
9263 | Either the startcoordinate or endCoordinate is not located i Denmark | Either the startcoordinate or endCoordinate is not located i Denmark |