Vantaan karttarajapinnat

Ajantasaiset kartat ja paikkatietoaineistot sovelluksiin ja paikkatieto-ohjelmistoihin.

Avoimet aineistot ovat käytettävissä ilman kirjautumista. Rajatut aineistot edellyttävät käyttöoikeutta. Kysy käyttöoikeuksista.

OGC API -rajapintapalvelut

PalveluKäyttötarkoitusOsoite ja aineistot
TilesRasterikarttatiilethttps://gis.vantaa.fi/geoserver/ogc/tiles/v1/
MapsKarttakuvathttps://gis.vantaa.fi/geoserver/ogc/maps/v1/
FeaturesPaikkatietokohteethttps://gis.vantaa.fi/geoserver/ogc/features/v1/

Uudet OGC API -standardit ovat edelleen kehitysvaiheessa. Rajapintojen käyttöönotto ja saatavuus määräytyvät sen mukaan, mitä toiminnallisuuksia GeoServer tukee.

Esimerkit ja käyttöohjeet

OGC API – Features

Hae paikkatietokohteita ja niiden ominaisuustietoja HTTP-rajapinnasta. Voit selata aineistoja selaimessa tai käyttää tietoja esimerkiksi GeoJSON-muodossa.

Avoimet aineistot ovat käytettävissä ilman kirjautumista. Rajatut aineistot edellyttävät käyttöoikeutta. Lisätietoja käyttöoikeuksista saat kartanmyynnistä.

Aineistot ja kohdehaut

Rajaa kohdehakua esimerkiksi bbox-parametrilla ja vastausten määrää limit-parametrilla. Tuetut parametrit ja esitysmuodot löytyvät API-dokumentaatiosta.

OpenAPI-kuvaus JSON-muodossa · Tuetut OGC-vaatimukset

OGC API – Maps

Hae karttakuva valitusta aineistosta ja karttatyylistä. Rajaa kuva kartta-alueen ja haluamasi kuvakoon mukaan.

Karttakuvan hakuosoitteet löytyvät aineiston karttatyyleistä. Määritä koordinaatisto crs-parametrilla, kartta-alue bbox-parametrilla ja kuvakoko width- ja height-parametreilla.

OGC API – Tiles

Hae valmiita rasterikarttatiiliä karttasovellukseen. Aineiston tiiliruudukko määrittää käytettävän koordinaatiston ja mittakaavatasot.

Käytä aineiston tiedoissa ilmoitettuja tiiliruudukon ja mittakaavatason tunnuksia. Rajatut aineistot edellyttävät käyttöoikeutta myös Maps- ja Tiles-palveluissa.

OGC-rajapinnat

PalveluKäyttötarkoitusOsoite ja aineistot
WMSKarttakuvathttps://gis.vantaa.fi/geoserver/wms
WMTSRasterikarttatiilethttps://gis.vantaa.fi/geoserver/gwc/service/wmts
WFSPaikkatietokohteethttps://gis.vantaa.fi/geoserver/wfs
Esimerkit, koordinaatistot ja aineistot

WMTS

Web Map Tile Service (WMTS) on tapa jakaa rasterimuotoista kartta-aineistoa ruudutettuna. WMTS-rajapinta tarjoaa kartan esityksen jaettuna pienempiin, helposti ladattaviin ruutuihin (tile), mikä nopeuttaa ja helpottaa suurten kartta-aineistojen käsittelyä ja esittämistä verkkoympäristössä. Standardin mukaiset kyselyt ovat GetCapabilities, GetTile ja GetFeatureInfo.

GetCapabilities:
https://gis.vantaa.fi/geoserver/gwc/service/wmts?request=GetCapabilities

GetTile:
https://gis.vantaa.fi/geoserver/gwc/service/wmts?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=taustakartta%3Akaupunkikartta&STYLE=&FORMAT=image%2Fpng&TILEMATRIXSET=EPSG%3A3879_yx&TILEMATRIX=EPSG%3A3879%3A10&TILEROW=577&TILECOL=487

WMS

Web Map Service on tapa jakaa rasterimuotoista kartta-aineistoa. Standardin mukaiset kyselyt ovat GetCapabilities, GetMap ja GetFeatureInfo.

Esimerkit kyselyistä

GetCapabilities:
https://gis.vantaa.fi/geoserver/wms?request=GetCapabilities

GetMap:
https://gis.vantaa.fi/geoserver/wms?TILED=false&FORMAT=image/png&LAYERS=taustakartta:ortoilmakuva&VERSION=1.1.1&REQUEST=GetMap&SRS=EPSG:3879&BBOX=25503204,6686968,25503332,6687096&WIDTH=256&HEIGHT=256

GetFeatureInfo:
https://gis.vantaa.fi/geoserver/wms?VERSION=1.3.0&REQUEST=GetFeatureInfo&BBOX=6686839,25502047,6686893,25502111&CRS=EPSG:3879&WIDTH=981&HEIGHT=822&LAYERS=gis:rakennukset&QUERY_LAYERS=gis:rakennukset&INFO_FORMAT=application/json&I=638&J=649

WFS

Web Feature Service on tapa jakaa vektorimuotoisia paikkatietokohteita. Standardin mukaiset kyselyt ovat GetCapabilities, DescribeFeatureType ja GetFeature.

Esimerkit kyselyistä

GetCapabilities:
https://gis.vantaa.fi/geoserver/wfs?request=GetCapabilities

DescribeFeatureType:
https://gis.vantaa.fi/geoserver/wfs?SERVICE=WFS&REQUEST=DescribeFeatureType&TYPENAME=gis:osoitteet

GetFeature:
https://gis.vantaa.fi/geoserver/wfs?SERVICE=WFS&REQUEST=GetFeature&TYPENAME=gis:osoitteet&cql_filter=katunimi%3D%27Kielotie%27

Rajapinta tukee hakuja Common Query Language (CQL) suodattimilla. Lisätietoja: GeoServer: CQL and ECQL

Lisätietoa rajapintojen standardeista saa Open Geospatial Consortiumin internetsivuilta.

Koordinaatistot (WMS & WFS)

Tunnus Koordinaattijärjestelmä
EPSG:3879 ETRS89 / GK25FIN on pääkaupunkiseudun kuntien käyttämä tasokoordinaatisto.
EPSG:3067 ETRS89 / TM35FIN on Suomessa valtakunnallisesti käytettävä tasokoordinaatisto.
EPSG:4326 WGS84 maantieteelliset koordinaatit, jossa on ilmaistu asteina maantieteellinen leveys (φ), maantieteellinen pituus (λ). Maantieteelliset WGS84-koordinaatit ovat mittaustarkkuuden puitteissa yhteneviä ETRS89-koordinaattien kanssa.
EPSG:3857 WGS 84 / Pseudo-Mercator eli ns. Web-mercator projektio on käytössä useissa karttapalveluissa, kuten Google Maps ja Open Street Map.

REST-rajapinnat

Vantaan paikkatietoja on mahdollista hakea myös REST/JSON rajapintojen kautta. REST-rajapinnoista saatavat aineistot ja niiden kuvaukset on lueteltu alla.

Osoitepaikannus

Palvelulla voi tehdä Vantaan osoite- ja kiinteistörekisteriin kohdistuen geokoodauksen tai käänteisen geokoodauksen kyselyitä. Palvelun tarkempi kuvaus: Paikannus API

Vantaan kaupungin avoimet työpaikat

Palvelusta voi hakea Vantaan avoimien työpaikkojen perustiedot ja toimipisteiden sijainnit. Palvelun tarkempi kuvaus: Vantaan työpaikat API

Anna palautetta rajapinnoista: paikkatietotuki@vantaa.fi