GeoService (Version 1, 2019-2)

Powered by 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.

Allowed organisations

A-kasse, STAR

Input

ElementTypeDetaljerForekomstBeskrivelse
GeocodeStructuredAddressRequestGeocodeStructuredAddressRequestType
1En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra.
-    StreetNamestringLength: 0-501Vejnavn.
-    StreetBuildingIdentiferstringPattern: ^([1-9][0-9]{0,2}[a-zA-Z]?)(-[1-9][0-9]{0,2}[a-zA-Z]?)?$1Husnummer.
-    FloorIdentifierstringPattern: [1-9]|[1-9][0-9]|KL|ST|kl|st|k[2-9]|K[2-9]0 - 1Etagenummer.
-    SuiteIdentifierstringLength: 0-40 - 1Dør angivelse, fx th.
-    PostCodeIdentifierstring
1Postnummer.
-    CountryIdentificationCodeCountryIdentificationCodeType
Base: _CountryIdentificationCodeType

1Landekode. Skal være i formatet ISO 3166 standard, alpha 2. (Eks. DK eller SE).
-    -    BaseType_CountryIdentificationCodeType
Base: string
Pattern: [a-z,A-Z]{2}|[a-z,A-Z]{3}|[0-9]{3}|[0-9]{4}1Dette 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

ElementTypeDetaljerForekomstBeskrivelse
GeocodeStructuredAddressResponseGeocodeStructuredAddressResponseType
1En return value som indeholder geokoderne og kvaliteten af dem.
-    GeoCoordinateGeoCoordinateType
1WGS84 koordinatpunkt.
-    -    Latitudedouble
1WGS84 breddegrad som decimaltal.
-    -    Longitudedouble
1WGS84 længdegrad som decimaltal.
-    GeoCoordinateQualityGeoCoordinateQualityTypeIdentifierType
1Angiver kvaliteten pĂĄ geokoordinaterne.

Fejlkoder

FejlkodeFejltekstBeskrivelse
9260Service call timeoutService call timeout
9261Service is unavailableService is unavailable
9262Geocoding was not possibleGeocoding was not possible

GeocodeSimpleAddress

Denne metode finder geocoordinaterne ud fra vejnavn, vejnummer og postnummer

Allowed organisations

A-kasse, STAR

Input

ElementTypeDetaljerForekomstBeskrivelse
GeocodeSimpleAddressRequestGeocodeSimpleAddressRequestType
1En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra.
-    StreetNameAndNumberstringLength: 0-1001Vejnavn og Husnummer.
-    PostCodeIdentifierstring
1Postnummer.
-    CountryIdentificationCodestring
0 - 1Landekode

Output

ElementTypeDetaljerForekomstBeskrivelse
GeocodeSimpleAddressResponseGeocodeSimpleAddressResponseType
1En return value som indeholder geokoderne og kvaliteten af dem.
-    GeoCoordinateGeoCoordinateType
1Geocoordinater.
-    -    Latitudedouble
1WGS84 breddegrad som decimaltal.
-    -    Longitudedouble
1WGS84 længdegrad som decimaltal.
-    GeoCoordinateQualityGeoCoordinateQualityTypeIdentifierType
1Kvalitet af geocoordinater.

Fejlkoder

FejlkodeFejltekstBeskrivelse
9260Service call timeoutService call timeout
9261Service is unavailableService is unavailable
9262Geocoding was not possibleGeocoding was not possible

CalculateDailyTravelTimeFromHome

Metoden udregner rejsetiden med offentlig transport fra bopæl til arbejdsplads. Tur/retur.

Allowed organisations

A-kasse, STAR

Input

ElementTypeDetaljerForekomstBeskrivelse
CalculateDailyTravelTimeFromHomeRequestCalculateDailyTravelTimeFromHomeRequestType
1En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra.
-    PersonCivilRegistrationIdentifierPersonCivilRegistrationIdentifierType
Base: string
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})|00000000001Borgers CPR nummer.
-    GeoCoordinateGeoCoordinateType
1WGS84 koordinatpunkt.
-    -    Latitudedouble
1WGS84 breddegrad som decimaltal.
-    -    Longitudedouble
1WGS84 længdegrad som decimaltal.

Output

ElementTypeDetaljerForekomstBeskrivelse
CalculateDailyTravelTimeFromHomeResponseCalculateDailyTravelTimeFromHomeResponseType
1En return value som indeholder afstanden i fugleflugt og rejse tiden med offentligtransport mellem de to afstande..
-    DailyTravelTimeint
0 - 1Forventet daglig rejsetid i minutter fra hjemmeadressen med offentlige transportmidler.
-    DistanceInMetersint
1Fugleflugtsafstand fra hjemmeadressen (en vejs).

Fejlkoder

FejlkodeFejltekstBeskrivelse
9259Could not find home address geographic coordinates for personCould not find home address geographic coordinates for person
9260Service call timeoutService call timeout
9261Service is unavailableService is unavailable
9263Either the startcoordinate or endCoordinate is not located i DenmarkEither the startcoordinate or endCoordinate is not located i Denmark

CalculateDailyTravelTime

Metoden udregner rejsetiden med offentlig transport mellem to geopunkter. Tur/retur.

Allowed organisations

A-kasse, STAR

Input

ElementTypeDetaljerForekomstBeskrivelse
CalculateDailyTravelTimeRequestCalculateDailyTravelTimeRequestType
1En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra.
-    GeoCoordinateOriginGeoCoordinateType
1WGS84 koordinatpunkt - Fra.
-    -    Latitudedouble
1WGS84 breddegrad som decimaltal.
-    -    Longitudedouble
1WGS84 længdegrad som decimaltal.
-    GeoCoordinateDestinationGeoCoordinateType
1WGS84 koordinatpunkt - Til.
-    -    Latitudedouble
1WGS84 breddegrad som decimaltal.
-    -    Longitudedouble
1WGS84 længdegrad som decimaltal.

Output

ElementTypeDetaljerForekomstBeskrivelse
CalculateDailyTravelTimeResponseCalculateDailyTravelTimeResponseType
1En return value som indeholder afstanden i fugleflugt og rejse tiden med offentligtransport mellem de to afstande..
-    DailyTravelTimeint
0 - 1Forventet daglig rejsetid i minutter fra hjemmeadressen med offentlige transportmidler.
-    DistanceInMetersint
1Fugleflugtsafstand fra hjemmeadressen (en vejs).

Fejlkoder

FejlkodeFejltekstBeskrivelse
9259Could not find home address geographic coordinates for personCould not find home address geographic coordinates for person
9260Service call timeoutService call timeout
9261Service is unavailableService is unavailable
9263Either the startcoordinate or endCoordinate is not located i DenmarkEither the startcoordinate or endCoordinate is not located i Denmark