ERDDAP
> wms
> Dokumentointi
ERDDAP :n Web Map Service (WMS ) -palvelun avulla voit pyytää kuvaa, jonka tiedot on piirretty kartalle.
WMS 
on
Open Geospatial Consortium (OGC ) 
ja
ISO (19128) 
standardi "rekisteröityjen ja päällekkäisten karttamaisten näkymien luomiselle ja näyttämiselle tiedoista, jotka tulevat samanaikaisesti useista etäisistä ja heterogeenisistä lähteistä".
See the
list of datasets available via WMS at this ERDDAP installation.
Kolme tapaa tehdä karttoja WMS llä
- Teoriassa kuka tahansa voi ladata, asentaa ja käyttää WMS -asiakasohjelmistoa.
Jotkut asiakkaat ovat:
ArcGIS
ja
uDig
.
Jotta nämä toimisivat, sinun on asennettava ohjelmisto tietokoneellesi.
Syötä sitten WMS palvelun URL-osoite asiakkaalle.
Esimerkiksi ArcGIS :ssä (ei vielä täysin toiminnassa, koska se ei käsittele aikaa!), käytä "Arc Catalog :
Add Service :
Arc Catalog Servers Folder :
GIS Servers :
Add WMS Server".
ERDDAP :ssa jokaisella tietojoukolla on oma WMS palvelunsa, joka sijaitsee osoitteessa
https://slocum-data.marine.rutgers.edu/erddap/fi /wms/ datasetID / request ?
Esimerkiksi:
https://slocum-data.marine.rutgers.edu/erddap/fi/wms/jplMURSST/request?
(Jotkin WMS asiakasohjelmat eivät halua ? -merkkiä URL-osoitteen loppuun.) See the list of datasets available via WMS at this ERDDAP installation.
Käytännössä emme ole löytäneet WMS asiakkaita, jotka käsittelevät oikein muita mittoja kuin pituus- ja leveysasteita (esim.
aika), WMS spesifikaatiossa määritellyn ominaisuuden, jota useimmat ERDDAP :n WMS palvelimien tietojoukot hyödyntävät.
Saatat huomata, että käyttämällä tietojoukon Tee kaavio -lomake ja valitse .kml tiedostotyyppi (OGC standardi) kuvien lataamiseksi
Google Earth
tarjoaa hyvän (ei WMS ) karttaasiakkaan.
See the list of datasets with Make A Graph at this ERDDAP installation.
- Web-sivujen tekijät voivat upottaa WMS asiakkaan verkkosivulle.
Esimerkiksi ERDDAP käyttää
Leaflet
, joka on erittäin monipuolinen WMS asiakas, jokaisen ERDDAP tietojoukon WMS sivulle (kuten tämä ).
See the list of datasets available via WMS at this ERDDAP installation.
Leaflet ei käsittele automaattisesti muita mittoja kuin pituus- ja leveysasteita (esim.
aika), joten sinun on kirjoitettava Java Script (tai muu komentosarjakoodi) tehdäksesi sen.
(Seikkailunhaluiset Java Script -ohjelmoijat voivat katsoa lähdekoodia verkkosivulta kuten tämä .)
Toinen yleisesti käytetty Java Script WMS -asiakasohjelma on
OpenLayers
.
- Henkilö, jolla on selain tai tietokoneohjelma, voi luoda erityisiä WMS URL-osoitteita.
Esimerkiksi:
- Näin saat kuvan, jossa on läpinäkymätön tausta kartta:
https://slocum-data.marine.rutgers.edu/erddap/fi/wms/jplMURSST/request?service=WMS&version=1.3.0&request=GetMap&bbox=-89.99,-179.99,89.99,180.0&time=2002-06-01T09:00:00Z&crs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=Land,jplMURSST:analysed_sst,Coastlines,Nations&styles=&format=image/png
- Näin saat kuvan, jossa on läpinäkyvä tausta kartta:
https://slocum-data.marine.rutgers.edu/erddap/fi/wms/jplMURSST/request?service=WMS&version=1.3.0&request=GetMap&bbox=-89.99,-179.99,89.99,180.0&time=2002-06-01T09:00:00Z&crs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=jplMURSST:analysed_sst&styles=&format=image/png&transparent=TRUE
See the list of datasets available via WMS at this ERDDAP installation.
Katso tiedot alta.
Käytännössä on helpompaa, monipuolisempaa ja tehokkaampaa käyttää tietojoukon Tee kaavio Web-sivua kuin käyttää WMS ää tähän tarkoitukseen.
See the list of datasets with Make A Graph at this ERDDAP installation.
GetCapabilities -pyyntö palauttaa XML-dokumentin, joka sisältää taustatietoja palvelusta ja perustiedot kaikesta tästä palvelusta saatavilla olevasta tiedosta.
Käytä tälle tietojoukolle WMS versiolle 1.3.0
https://slocum-data.marine.rutgers.edu/erddap/fi/wms/jplMURSST/request?service=WMS&request=GetCapabilities&version=1.3.0
GetCapabilities pyynnön tuetut parametrit ovat:
nimi=arvo * |
Kuvaus |
service=WMS |
Edellytetään. |
version = versio |
Tällä hetkellä ERDDAP :n WMS tukee "1.1.0", "1.1.1" ja "1.3.0".
Tämä parametri on valinnainen.
Oletusarvo on "1.3.0". |
request=GetCapabilities |
Edellytetään. |
* Parametrien nimissä kirjainkoolla ei ole merkitystä.
Parametriarvot ovat isot ja pienet kirjaimet erottuvat ja niiden on oltava
prosenttikoodattuja 
:
kaikki muut kyselyarvojen merkit kuin A-Za-z0-9_-!.~'()* on koodattava muodossa %HH, missä HH on merkin 2-numeroinen heksadesimaaliarvo, esimerkiksi välilyönnistä tulee %20.
Yli 127:n merkit on muutettava UTF-8-tavuiksi, minkä jälkeen jokainen UTF-8-tavu on prosenttikoodattava (pyydä ohjelmoijalta apua).
On olemassa
verkkosivustoja, jotka koodaavat/purkaavat sinua puolestasi 
.
Parametrit voivat olla missä tahansa järjestyksessä URL-osoitteessa, erotettuna &-merkillä.
Henkilö, jolla on selain tai tietokoneohjelma, voi luoda erityisen URL-osoitteen kartan pyytämistä varten.
URL-osoitteen on oltava muodossa
https://slocum-data.marine.rutgers.edu/erddap/fi /wms/
datasetID / request ?
kysely
WMS GetMap -pyynnön kysely koostuu useista
parametreista parametriName=value, jotka on erotettu &-merkillä.
Esimerkiksi,
https://slocum-data.marine.rutgers.edu/erddap/fi/wms/jplMURSST/request?service=WMS&version=1.3.0&request=GetMap&bbox=-89.99,-179.99,89.99,180.0&time=2002-06-01T09:00:00Z&crs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=Land,jplMURSST:analysed_sst,Coastlines,Nations&styles=&format=image/png
GetMap pyynnön
parametrivaihtoehdot ovat:
nimi=arvo * |
Kuvaus |
service=WMS |
Edellytetään. |
version = versio |
Pyydä versio.
Tällä hetkellä ERDDAP :n WMS tukee "1.1.0", "1.1.1" ja "1.3.0".
Edellytetään. |
request=GetMap |
Pyydä nimi.
Edellytetään. |
layers = layer_list |
Pilkuilla eroteltu luettelo yhdestä tai useammasta karttatasosta.
Tasot piirretään siinä järjestyksessä, jossa ne esiintyvät luettelossa.
Tällä hetkellä ERDDAP :n WMS ssä tietojoukkojen tasojen nimet ovat nimeltään datasetID : muuttujanNimi .
ERDDAP :n WMS ssä on viisi tasoa, jotka eivät perustu ERDDAP -tietosarjoihin:
- "Land" voidaan piirtää ENNEN (alakerroksena) tai JÄLKEEN (maamaskina) tasoja ruudukkotietosarjoista.
- "Coastlines" tulee yleensä piirtää ruudukkotietojoukon tasojen JÄLKEEN.
- "LakesAndRivers" piirtää järviä ja jokia.
Tämä tulee yleensä piirtää tasojen JÄLKEEN ruudukkotietojoukoista.
- "Nations" vetää kansallisia poliittisia rajoja.
Tämä tulee yleensä piirtää tasojen JÄLKEEN ruudukkotietojoukoista.
- "States" vetää valtioiden poliittiset rajat.
Tämä tulee yleensä piirtää tasojen JÄLKEEN ruudukkotietojoukoista.
Edellytetään. |
styles = style_list |
Pilkuilla eroteltu luettelo, jossa on yksi renderöintityyli pyydettyä tasoa kohden.
Tällä hetkellä ERDDAP :n WMS ssä ainoa jokaiselle tasolle tarjolla oleva tyyli on oletustyyli, joka määritetään "" (ei mitään).
Jos esimerkiksi pyydät 3 tasoa, voit käyttää "styles=,,".
Tai vielä helpommin voit pyytää oletustyyliä kaikille tasoille "styles="-komennolla.
Edellytetään. |
1.1.0:
srs= namespace:identifier
1.1.1:
srs= namespace:tunniste
1.3.0:
crs= namespace:identifier |
Koordinaattien viitejärjestelmä.
Tällä hetkellä ERDDAP :n WMS 1.1.0:ssa ainoa kelvollinen SRS on EPSG:4326.
Tällä hetkellä ERDDAP :n WMS 1.1.1:ssä ainoa voimassa oleva SRS on EPSG:4326.
Tällä hetkellä ERDDAP :n WMS 1.3.0:ssa ainoat voimassa olevat CRS:t ovat CRS:84 ja EPSG:4326,
Edellytetään. |
bbox= 4commaSeparatedValues |
Rajauslaatikon kulmat SRS/CRS-yksiköissä.
Versiolle = 1.3.0, jossa CRS = EPSG:4326, 4 arvoa ovat:
minLat,minLon,maxLat,maxLon.
Kaikissa muissa tilanteissa 4 arvoa ovat:
minLon,minLat,maxLon,maxLat.
(Käänteinen järjestys! Kyllä, se on outoa.
Tervetuloa OGC :n maailmaan!) ERDDAP tukee pyyntöjä tietojoukon pituusasteilla (ehkä 0 - 360, ehkä -180 - 180) ja leveysasteilla.
Useimmat WMS asiakkaat olettavat, että pituusastearvot ovat välillä -180–180.
Jos ERDDAP tarjoaa muunnelman tietojoukosta, jonka pituusaste on -180–180, käytä sitä WMS pyyntöihin.
Edellytetään. |
width = output_width |
Karttakuvan leveys pikseleinä.
Edellytetään. |
height = lähtö_korkeus |
Karttakuvan korkeus pikseleinä.
Edellytetään. |
format = lähtömuoto |
Kartan tulostusmuoto.
Tällä hetkellä ERDDAP :n WMS :ssä vain kuva/png on voimassa.
Edellytetään. |
transparent=TRUE|FALSE |
Kartan taustan läpinäkyvyys.
Valinnainen (oletus= FALSE ).
Jos TRUE, mikä tahansa BGColor-väriä käyttävä kuvan osa tehdään läpinäkyväksi. |
bgcolor = väri_arvo |
Heksadesimaali 0xRRGBB-väriarvo taustavärille.
Valinnainen (oletus = 0xFFFFFF, valkoinen).
Jos transparent=true, suosittelemme bgcolor =0x808080 (harmaa), koska valkoinen on joissakin väripaleteissa. |
exceptions = poikkeus_muoto |
WMS poikkeusvastausten muoto.
Valinnainen.
Tällä hetkellä ERDDAP :n WMS 1.1.0 ja 1.1.1 tukevat "application/vnd.ogc.se_xml" (oletus),
"application/vnd.ogc.se_blank" (tyhjä kuva) ja "application/vnd.ogc.se_inimage" (virhe kuvassa).
Tällä hetkellä ERDDAP :n WMS 1.3.0 tukee "XML" (oletus), "BLANK" (tyhjä kuva) ja
"INIMAGE" (virhe kuvassa). |
time = aika |
Halutun kerroksen aika-arvo määritettynä ISO 8601 -muodossa:
yyyy-MM-ddTHH:mm:ssZ .
Tällä hetkellä ERDDAP :n WMS ssä voit määrittää vain yhden aika-arvon pyyntöä kohden.
ERDDAP :n WMS ssä käytetään lähimpänä määrittämääsi arvoa (jos välillä min ja max).
ERDDAP :n WMS :ssä oletusarvo on tietojoukon 1D-aikataulukon viimeinen arvo.
ERDDAP :n WMS ssä "nykyinen" tulkitaan viimeiseksi käytettävissä olevaksi ajaksi (äskettäin tai ei).
Valinnainen (ERDDAP :n WMS :ssä oletusarvo on viimeinen arvo, olipa se uusi tai ei). |
elevation = korkeus |
Haluttu kerroksen korotus.
Tällä hetkellä ERDDAP :n WMS ssä voit määrittää vain yhden korkeusarvon pyyntöä kohden.
ERDDAP :n WMS :ssä tätä käytetään korkeus- tai syvyysmitta (muunnettu korkeudeksi) (jos sellainen on).
(metreinä, positiivinen = ylös)
ERDDAP :n WMS ssä käytetään lähimpänä määrittämääsi arvoa (jos välillä min ja max).
Valinnainen (ERDDAP :n WMS :ssä oletusarvo on tietojoukon 1D-korkeus- tai syvyystaulukon viimeinen arvo). |
dim_ nimi = arvo |
Muiden mittojen arvo tarvittaessa.
Tällä hetkellä ERDDAP :n WMS ssä voit määrittää vain yhden arvon ulottuvuutta kohden pyyntöä kohden.
ERDDAP :n WMS ssä tätä käytetään ei-aika-, ei-korkeus- ja ei-syvyysmitoille.
Mittasuhteen nimi on "dim_" plus tietojoukon nimi ulottuvuudelle, esimerkiksi "dim_model".
ERDDAP :n WMS ssä käytetään lähimpänä määrittämääsi arvoa (jos välillä min ja max).
Valinnainen (ERDDAP :n WMS :ssä oletusarvo on ulottuvuuden 1D-taulukon viimeinen arvo).
|
* Parametrien nimissä kirjainkoolla ei ole merkitystä.
Parametriarvot ovat isot ja pienet kirjaimet erottuvat ja niiden on oltava
prosenttikoodattuja 
:
kaikki muut kyselyarvojen merkit kuin A-Za-z0-9_-!.~'()* on koodattava muodossa %HH, missä HH on merkin 2-numeroinen heksadesimaaliarvo, esimerkiksi välilyönnistä tulee %20.
Yli 127:n merkit on muutettava UTF-8-tavuiksi, minkä jälkeen jokainen UTF-8-tavu on prosenttikoodattava (pyydä ohjelmoijalta apua).
On
verkkosivustoja, jotka koodaavat/purkaavat prosenttiosuuksia puolestasi 
.
Parametrit voivat olla missä tahansa järjestyksessä URL-osoitteessa, erotettuna &-merkillä.
(Tarkennettu WMS 1.3.0 -määrityksen taulukosta 8)
- Tietojoukon vaatimukset: Tärkeimmät vaatimukset muuttujan pääsylle ERDDAP :n WMS palvelimen kautta ovat:
- Tietojoukon on oltava EDDGrid ...
-tietojoukko.
- Datamuuttujan PITÄÄ olla ruudukkomuuttuja.
- Datamuuttujalla PITÄÄ olla pituus- ja leveysaste-akselimuuttujat.
(Muut akselimuuttujat ovat VALINNAisia.)
- Pituusaste-arvoja TÄYTYY olla välillä -180 ja 180.
- Attribuutit colorBarMinimum ja colorBarMaximum TÄYTYY määrittää.
(Muut väripalkin määritteet ovat VALINNAisia.)
- Ruudukkotietokerrokset: ERDDAP :n WMS ssä kaikki pituus- ja leveysastemittoja käyttävien ruudukkotietojoukkojen datamuuttujat ovat saatavilla WMS kautta.
Jokainen tällainen muuttuja on saatavilla WMS kerroksena, jonka nimi on datasetID : muuttujanNimi .
Jokainen tällainen kerros on läpinäkyvä (eli data-arvot esitetään värialueena ja puuttuvat arvot esitetään läpinäkyvinä pikseleinä).
- Taulukkotietokerrokset: Tällä hetkellä ERDDAP :n WMS ssä taulukkotietojoukkojen datamuuttujat eivät ole käytettävissä WMS kautta.
- Mitat: WMS suunnittelun seurauksena GetMap pyynnössä määrittämäsi AIKA-, KORKEUS- ja muut mitta-arvot koskevat kaikkia tasoja.
Eri tasoille ei voi määrittää eri arvoja.
- Tiukka? Yllä oleva taulukko määrittää, kuinka asiakkaan tulee muodostaa GetMap pyyntö.
Käytännössä ERDDAP :n WMS yrittää olla mahdollisimman lempeä käsitellessään GetMap pyyntöjä, koska monet nykyiset asiakkaat eivät noudata määritystä.
Jos kuitenkin muodostat GetMap URL-osoitteita, suosittelemme, että yrität noudattaa määrityksiä.
- Miksi jokaiselle tietojoukolle on erilliset WMS palvelimet? Koska GetCapabilities asiakirjassa luetellaan jokaisen tietojoukon kaikkien ulottuvuuksien kaikki arvot, kunkin tietojoukon tiedot voivat olla suuria (helposti 300 kt).
Jos kaikki ERDDAP pääsivuston ruudukkotietojoukot (tällä hetkellä noin 1000) sisällytettäisiin yhteen WMS, tuloksena oleva GetCapabilities dokumentti olisi valtava (~300 Mt), jonka lataaminen kestäisi kauan (saattaa monet ihmiset ajattelemaan jotain oli väärässä ja luovutti) ja se kuormittaisi useimmat asiakasohjelmistot.
ERDDAP is compatible with the current WMS 1.3.0 standard.
ERDDAP is also compatible with the older
WMS 1.1.1 standard, which may be needed when working with older client software.
ERDDAP is also compatible with the older
WMS 1.1.0 standard, which may be needed when working with older client software.