Guide til Skråfoto API v.2.0

Guide til Skråfoto API v.2.0

Brugervejledning til Skråfoto API. Vers. 2.0 (20190719).

Access til API

API er hosted i Amazon AWS API Gateway som REST API’er

Følgende API’er findes pt.

NavnBeskrivelse
get-oblique-imageHenter skråfoto for et angivet punkt (target) angivet ved geografiske koordinater

Bemærk

Performance

Vi vedligeholder en permanent cache over de skråfotos der har været vist. Første gang et billede hentes kan det tage flere sekunder. Herefter tager det i gennemsnit 100-200 ms at hente et billede.


Centrering

Vi returnerer det flyfoto som viser den ønskede lokation i den bedste vinkel. Ofte vil lokationen dog ikke være i centrum af billedet når der zoomes ind. Der en option ’center’ som kan benyttes hvis lokationen altid ønskes i midten af billedet.


Dato for optagelse

Vi returnerer nu dato/tid for optagelse af flyfotoet. Det returneres i UTC tidszone.

get-oblique-image

Interface til at hente skråfoto for et angivet punkt (target) angivet ved geografiske koordinater. Enten WGS84 (Lat, Long) eller UTM32 (easting, northing).

Der returneres et skråfoto og de omtrentlige kooordinater i pixelkoordinater for target.


Request

URL: <URL, will be distributed separately>

HTTP Request type: POST


Headers

ElementKrævetBeskrivelseEksempel
X-API-KEYJaLicenskoden til API.
Distribueres separat.
”ghtQjXHTnC1JpFO6Txk8G1twQfm1hhA956hN8EnJ”


Parameters

ElementKrævetBeskrivelseEksempel
interfaceVersionJaDen version af interfacet som request er beregnet for. P.t. version 1.0.”1.0”
latJa *)WGS84 latitude55.68133881
lngJa *)WGS84 latitude12.5757717
eastingJa *)UTM32 easting723571.5002991187
northingJa *)UTM32 northing6179535.410903961
directionJa”N” : mod nord
”S” : mod syd
”W”: mod vest
”E”: mod øst
”T”: oppefra
”N”
zoomFactorNej10, 11 , 12, 13 eller 14. Default er 14”14”
centerNej ”true” eller ”false”. Default = ”false”.
Der returneres et billede hvor target er
centreret.
“true”
versionNej Hvis angivet ignoreres alle andre
parametre og versionsnummeret på
servicen returneres. F.eks.
”oblique-service v2.0.0 (get-obliqueimage-
v2) version:12”
“true”

*) Enten skal lat og long begge angives eller både easting og northing.

Eksempel:

{
    "interfaceVersion": "1.0",
    "easting": "723571.5002991187",
    "northing": "6179535.410903961",
    "direction": "N",
    "zoomFactor": "14"
}

Return Codes

Return CodeMeaning
200Success
400Missing or wrong parameters
401Wrong Interface Version
402No Oblique Photo Available for area
403Bad or missing X-API-KEY header
500System Error

Response

Der returneres en JSON struktur med følgende elementer:

NavnBeskrivelse
widthBredde af billedet i pixels
heightHøjde af billedet i pixels
xApproximate x pixel coordinate for target. (0) is left edge
yApproximate y pixel coordinate for target. (0) is top edge
imageBase64 encoded image
timeutcOptagelsesdato og -tidspunkt for billedet i UTC tidszone.

Example return:

{
    "width": 10288,
    "height": 7696,
    "x": 387,
    "y": 227,
    "timeutc": "2019-04-01T14:54:39.000Z",
    "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHS
UfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoK
CgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAQCBAIDASIAAhEBAxEB/8QAHwAAAQUB
AQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJ
xFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaG
lqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2
uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgEC
BAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJyg
pKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpa
anqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAP
wDW1qyZLoQElbZnDZHXb3FWZm0qzIW1tjJIcEGQk1v3lrHdJhx06H3rjb5HjklEo+dDj8BXnpcmxtUh1DX5
LnUoxBGUjZgAuBkLk15Hr2h3dnqbosLyOWIyqnDe4r1aGaIMGRgwHcGqd1cloiI8kgEMPQ+lP4tyEzntLd7
SydYonKQwmaYf3QBkmui+HOszzx3MN
..more..
..more..
"
}

Example 2:

Request:

{
    "interfaceVersion": "1.0",
    "lat": "55.68133881",
    "lng": "12.5757717",
    "direction": "E",
    "zoomFactor": "14"
}

Response:

{
    "width": 7696,
    "height": 10288,
    "x": 302,
    "y": 294,
    "timeutc": "2019-04-01T14:54:39.000Z",
    "image":
"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHS
UfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/

Resulting image: