ERDDAP > RESTful Web Services
ERDDAP on molemmat:
- Verkkosovellus
– Web-sivu, jossa on lomake, jota selaimet käyttävät ihmiset voivat käyttää (tässä tapauksessa tietojen, kaavioiden tai tietoaineistojen tietojen hankkimiseen).
- RESTful verkkopalvelu – URL-osoite, jota tietokoneohjelmat voivat käyttää (tässä tapauksessa saadakseen tietoja, kaavioita ja tietoja tietojoukoista).
Jokaiselle ERDDAP -verkkosivulle, jolla on lomake, jota sinä selaimen käyttäjänä voit käyttää, on vastaava ERDDAP -verkkopalvelu, joka on suunniteltu tietokoneohjelmien ja komentosarjojen helppokäyttöisiksi.
Esimerkiksi ihmiset voivat käyttää tätä URL-osoitetta tehdäkseen kokotekstihaun mielenkiintoisille tietojoukoille:
https://slocum-data.marine.rutgers.edu/erddap/fi/search/index.html?page=1&itemsPerPage=1000&searchFor=temperature
Muuttamalla URL-osoitteen tiedostotunnisteen .html muotoon .json (tai .csv tai .htmlTable tai .jsonlCSV1 tai .xhtml, ...):
https://slocum-data.marine.rutgers.edu/erddap/fi/search/index.json?page=1&itemsPerPage=1000&searchFor=temperature
saamme URL-osoitteen, jota tietokoneohjelma tai Java Script -komentosarja voi käyttää saadakseen samat tiedot tietokoneohjelmaystävällisemmässä muodossa, kuten
JSON .
ERDDAP ssa on monia ominaisuuksia, joita kirjoittamasi tietokoneohjelmat tai komentosarjat voivat käyttää.
Voit käyttää niitä muiden verkkosovellusten tai verkkopalvelujen rakentamiseen ERDDAP päälle, jolloin ERDDAP tekee suurimman osan työstä! Joten jos sinulla on idea paremmasta käyttöliittymästä ERDDAP palvelemiin tietoihin tai verkkosivulle, joka tarvitsee helpon tavan päästä tietoihin, suosittelemme luomaan oman verkkosovelluksesi, verkkopalvelusi tai verkkosivusi ja käyttämään ERDDAP perusta.
Järjestelmäsi voi saada tietoja, kaavioita ja muuta tietoa ERD :n ERDDAP sta tai muista ERDDAP asennuksista, tai voit
perustaa oma ERDDAP -palvelin, joka voi olla julkisesti tai vain yksityisesti käytettävissä.
ERDDAP :n käyttöliittymätietojen pyynnöt (esimerkiksi hakutulokset) käyttävät verkon yleistä standardia pyynnöille:
URL-osoitteet lähetetty
HTTP GET kautta .
Tämä on sama mekanismi, jota selaimesi käyttää, kun täytät lomakkeen verkkosivulla ja napsautat
Submit Jos haluat käyttää HTTP GET, luo erityisesti muodostettu URL-osoite (joka voi sisältää kyselyn) ja lähetä se HTTP GET avulla.
Voit muodostaa nämä URL-osoitteet käsin ja kirjoittaa ne selaimesi osoitetekstikenttään (esim.
https://slocum-data.marine.rutgers.edu/erddap/fi/search/index.json?page=1&itemsPerPage=1000&searchFor=temperature)
Tai voit kirjoittaa tietokoneohjelman tai verkkosivun komentosarjan luodaksesi URL-osoitteen, lähettääksesi sen ja saada vastauksen.
URL-osoitteet HTTP GET kautta valittiin, koska
URL-osoitteissa jotkin merkit eivät ole sallittuja (esimerkiksi välilyönnit) ja muilla merkeillä on erityismerkitys (esimerkiksi & erottaa avain=arvo-parit kyselyssä).
Kun täytät lomakkeen Web-sivulla ja napsautat Lähetä, selaimesi automaattisesti
koodaa URL-osoitteen erikoismerkit (esimerkiksi välilyönnistä tulee %20), esimerkiksi
https://slocum-data.marine.rutgers.edu/erddap/fi/search/index.html?page=1&itemsPerPage=1000&searchFor=temperature%20wind%20speed
Mutta jos tietokoneohjelmasi tai komentosarjasi luo URL-osoitteet, sen on luultavasti tehtävä prosenttikoodaus itse.
Jos näin on, niin luultavasti kaikki muut merkit paitsi A-Za-z0-9_-!.~'()* kyselyn arvoissa ('=' -merkkien jälkeiset osat) 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).
Ohjelmointikielillä on työkaluja tähän (katso esimerkiksi Java :n
java.net.URLEncoder ja Java Scriptin
encodeURIComponent() ), ja on
verkkosivustoja, jotka koodaavat/purkaavat sinua puolestasi
Vaikka selainta käyttävät ihmiset haluavat saada käyttöliittymätuloksia (esimerkiksi hakutuloksia) HTML-dokumentteina, tietokoneohjelmat haluavat usein saada tulokset yksinkertaisissa, helposti jäsennetyissä ja vähemmän monisanaisissa asiakirjoissa.
ERDDAP voi palauttaa käyttöliittymätuloksia tietotaulukona näissä yleisissä tietokoneohjelmaystävällisissä tiedostotyypeissä:
- .csv - pilkuilla erotettu ASCII-tekstitaulukko.
(lisää tiedot )
- .htmlTable - .html-verkkosivu, jonka tiedot ovat taulukossa.
(lisää tiedot )
- .itx - Igor-tekstitiedosto, jossa on aalto jokaiselle tietosarakkeelle.
(lisää tiedot )
- .json - taulukkomainen JSON-tiedosto.
(lisää tiedot tai
ERDDAP -kohtaiset tiedot)
- .jsonlCSV1 – "Parempi kuin CSV" JSON Lines -tiedosto, jonka ensimmäisellä rivillä on sarakkeiden nimet.
(lisää tiedot )
- .jsonlCSV – "Parempi kuin CSV" JSON Lines -tiedosto ilman sarakkeiden nimiä.
(lisää tiedot )
- .jsonlKVP – JSON Lines -tiedosto, jossa on avain:arvo-pareja.
(lisää tiedot )
- .mat - MATLAB-binaaritiedosto.
(lisää tiedot )
- .nc - litteä, taulukkomainen NetCDF -3 binaaritiedosto.
(lisää tiedot )
- .nccsv - litteä, taulukkomainen, NetCDF :n kaltainen ASCII CSV-tiedosto.
(lisää tiedot )
- .tsv - sarkaimilla eroteltu ASCII-tekstitaulukko.
(lisää tiedot )
- .xhtml - XHTML (XML) -tiedosto, joka sisältää tiedot taulukossa.
(lisää tiedot )
Jokaisessa tulostaulukon muodossa (paitsi .jsonlKVP, jossa sarakkeiden nimet ovat joka rivillä):
- Jokaisella sarakkeella on sarakkeen nimi ja yksi tietotyyppi.
- Taulukon ensimmäisellä rivillä on sarakkeiden nimet.
- Seuraavilla riveillä on pyytämäsi tiedot.
Näiden tavallisten tiedostotyyppien sisältö poikkeaa myös hieman .html-vastauksesta – se on tarkoituksella paljastettu, jotta tietokoneohjelman on helpompi käsitellä sitä.
Johdonmukainen tietorakenne vastauksille
Kaikki tällä sivulla kuvatut käyttöliittymäpalvelut voivat palauttaa tietotaulukon missä tahansa yllä luetelluista yleisistä tiedostomuodoista.
Toivottavasti voit kirjoittaa vain yhden menettelyn datataulukon jäsentämiseksi jossakin muodossa.
Sitten voit käyttää tätä menettelyä uudelleen jäsentääksesi vastauksen mistä tahansa näistä palveluista.
Tämän pitäisi helpottaa ERDDAP käsittelyä.
.csv- ja .tsv tiedot
- Jos .csv-tiedoston datumissa on sisäiset lainausmerkit tai pilkut, ERDDAP noudattaa tiukasti .csv-määrityksiä:
se laittaa lainausmerkit datamin ympärille ja kaksinkertaistaa sisäiset lainausmerkit.
- .csv- tai .tsv tiedoston erikoismerkit on koodattu kuten
JSON kenoviivakoodatut merkit:
\n (uusirivi), \\ (kenoviiva), \f (lomakkeen syöttö), \t (sarkain), \r (rivinvaihto) tai syntaksilla \u hhhh .
jsonp
.json -tiedostopyynnöt voivat nyt sisältää valinnaisen
jsonp pyyntö lisäämällä "& .json p= functionName" kyselyn loppuun.
Periaatteessa tämä käskee ERDDAP lisäämään "funktionNimi (" vastauksen alkuun ja ")" vastauksen loppuun.
FunctionName-funktion ensimmäisen merkin on oltava ISO 8859 -kirjain tai "_".
Jokaisen valinnaisen myöhemmän merkin on oltava ISO 8859 -kirjain, "_", numero tai ".".
Jos alun perin kyselyä ei ollut, jätä "&" pois kyselystäsi.
griddap ja tabledap tarjoavat erilaisia tiedostotyyppejä
Yllä luetellut tiedostotyypit ovat tiedostotyyppejä, joita ERDDAP voi käyttää vastaamaan käyttöliittymätyyppisiin pyyntöihin (esimerkiksi hakupyyntöihin).
ERDDAP tukee erilaisia tiedostotyyppejä tieteellisten tietojen (esimerkiksi satelliitti- ja poijutietojen) pyyntöihin (katso
griddap- ja
tabledap dokumentaatio).
ERDDAP ei tarjoa tuloksia, jotka on tallennettu pakattuihin tiedostoihin (esim.
.zip tai .gzip ).
Sen sijaan ERDDAP etsii
hyväksyntäkoodausta asiakkaan lähettämässä HTTP GET -pyynnön otsikossa.
Jos tuettu pakkaustyyppi (gzip, x-gzip tai deflate ) löytyy hyväksymiskoodausluettelosta, ERDDAP sisällyttää "sisällön koodauksen" HTTP-vastauksen otsikkoon ja pakkaa tiedot lähettäessään niitä.
Asiakasohjelman tehtävänä on etsiä
content-encoding ja purkaa tiedot sen mukaisesti.
Pakkaamisen pyytäminen on valinnaista, mutta pakatut vastaukset ovat usein 3-10 kertaa nopeampia, joten tämä säästää paljon aikaa, jos lataat paljon suuria tiedostoja.
(Huomaa, että pakattujen .png-tiedostojen pyytämisestä ei ole hyötyä, koska tiedostojen sisältö on jo pakattu.)
- Oletuksena selaimet ja OPeNDAP asiakkaat pyytävät aina pakattua tietoa ja purkaa palautetut tiedot.
- Lisää curl komentoriville --compressed, jotta curl pyytää pakattua vastausta ja purkaa sen automaattisesti.
- Muiden asiakasohjelmistojen kanssa olet määrittänyt tämän erikseen.
Tässä on
Java esimerkki .
Tässä on
esimerkki Python (vaikka sinun tulee joko käsitellä deflate 'd -vastauksia tai olla pyytämättä deflate).
ERDDAP lla on seuraavat URL-osoitteet tietokoneohjelmille:
- Saat luettelon tärkeimmistä resurssien URL-osoitteista käyttämällä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saat nykyisen luettelon kaikista tietojoukoista käyttämällä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Jos haluat saada tietyn tietojoukon metatiedot (muuttujien luettelo ja niiden attribuutit), käytä
https://slocum-data.marine.rutgers.edu/erddap/fi /info/ datasetID /index .fileType
esimerkiksi,
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saadaksesi tulokset tietojoukkojen kokotekstihakuista (käyttäen esimerkkinä "searchFor=wind%20speed" )
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
(Ohjelmasi tai komentosarjasi on ehkä
prosenttikoodattava -arvo kyselyssä.)
Tai käytä
OpenSearch 1.1 -standardia täystekstihaun tekemiseen tietojoukoille.
- Saadaksesi tulokset tarkennetuista tietojoukkojen hauista (käyttäen esimerkkinä "searchFor=wind%20speed" )
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
Mutta kokeile
Tarkennettu Haku selaimessa selvittääksesi kaikki valinnaiset parametrit.
(Ohjelmasi tai komentosarjasi on ehkä
prosenttikoodattava -arvo kyselyssä.)
- Saadaksesi luettelon categoryAttributes (esimerkiksi laitos, long_name, vakio_nimi), käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Jos haluat saada luettelon tietyn kategorian attribuutista (käyttäen "standardi_nimi" esimerkkinä), käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saadaksesi luettelon tietyn luokan tietojoukoista (käyttäen esimerkkinä "standardi_nimi=aika") käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saadaksesi nykyisen luettelon kaikista tietyn protokollan kautta saatavilla olevista tietojoukoista,
- Griddap:
käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- tabledap :
käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- WMS: käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV1,
.jsonlCSV,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Griddapissa ja tabledap on monia verkkopalveluita, joita voit käyttää.
- Data Access Forms ovat vain yksinkertaisia verkkosivuja, joilla luodaan tietoja (esimerkiksi satelliitti- ja poijutietoja) pyytäviä URL-osoitteita.
Tiedot voivat olla missä tahansa useista yleisistä tiedostomuodoista.
Ohjelmasi voi luoda nämä URL-osoitteet suoraan.
Katso lisätietoja
griddap-dokumentaatiosta ja
tabledap dokumentaatiosta .
- Make A Graph -sivut ovat vain yksinkertaisia verkkosivuja, joilla luodaan URL-osoitteita, jotka pyytävät kaavioita tietojen osajoukosta.
Kaaviot voivat olla missä tahansa useista yleisistä tiedostomuodoista.
Ohjelmasi voi luoda nämä URL-osoitteet suoraan.
Katso lisätietoja
griddap-dokumentaatiosta ja
tabledap dokumentaatiosta .
- Saadaksesi tietojoukon rakenteen, mukaan lukien muuttujien nimet ja tietotyypit, käytä standardia OPeNDAP
.dds pyyntö.
Esimerkiksi,
https://slocum-data.marine.rutgers.edu/erddap/fi/griddap/jplMURSST .dds (ruudukkotiedot) tai
https://slocum-data.marine.rutgers.edu/erddap/fi/tabledap/pmelTaoDySst .dds (taulukkotiedot).
- Saadaksesi tietojoukon metatiedot, käytä standardia OPeNDAP
.das pyyntö.
Esimerkiksi,
https://slocum-data.marine.rutgers.edu/erddap/fi/griddap/jplMURSST .das (ruudukkotiedot) tai
https://slocum-data.marine.rutgers.edu/erddap/fi/tabledap/pmelTaoDySst .das (taulukkotiedot).
- ERDDAP on erityinen taulukkomuotoinen tietojoukko nimeltä
allDatasets, jossa on tiedot kaikista tässä ERDDAP tällä hetkellä saatavilla olevista tietojoukoista.
Jokaiselle tietojoukolle on oma rivi.
Siellä on sarakkeita, joissa on erityyppisiä tietoja (esimerkiksi datasetID, otsikko, yhteenveto, laitos, lisenssi, Data Access Form URL, Make A Graph URL).
Koska tämä on tabledap -tietojoukko, voit käyttää tabledap -tietopyyntöä pyytääksesi tiettyjä sarakkeita ja rivejä, jotka vastaavat rajoituksia, ja voit saada vastauksen missä tahansa vastaustiedostotyypissä, esimerkiksi .html, .xhtml, .csv., .json, .jsonlCSV1, .jsonlCSV tai .jsonlKVP .
- ERDDAP :n muissa protokollissa on myös verkkopalveluita, joita voit käyttää.
Katso
- ERDDAP tarjoaa
RSS tilauksia, jotta tietokoneohjelmasi voi selvittää, onko tietojoukko muuttunut.
- ERDDAP tarjoaa
sähköposti-/URL-tilauksia, jotka ilmoittavat tietokoneohjelmallesi aina, kun tietojoukko muuttuu.
- ERDDAP tarjoaa useita muuntimia verkkosivuina ja verkkopalveluina:
- ERDDAP on järjestelmä, joka pitää kirjaa
vanhentuneista tietojoukoista .
Katso Asetukset kyseisen verkkosivun alalaidasta.
Jos sinulla on ehdotuksia lisälinkkeistä, ota yhteyttä
erd dot data at noaa dot gov .
Kuten edellä on kuvattu, koska Java ohjelmat voivat käyttää verkossa saatavilla olevia tietoja, voit kirjoittaa Java ohjelman, joka käyttää tietoja mistä tahansa julkisesti saatavilla olevasta ERDDAP asennuksesta.
Tai koska ERDDAP on täysin avoimen lähdekoodin ohjelma, voit myös asettaa oman ERDDAP -kopion omalle palvelimellesi (julkisesti saatavilla tai ei) palvelemaan omia tietojasi.
Java ohjelmasi voivat saada tietoja kyseisestä ERDDAP - kopiosta .
Katso
Oman ERDDAP määrittäminen .
Monissa ERDDAP -asennuksissa ei ole käytössä todennusta, joten käyttäjät eivät voi kirjautua sisään eikä niillä ole yksityisiä tietojoukkoja.
Joissakin ERDDAP asennuksissa todennus on käytössä.
Tällä hetkellä ERDDAP tukee vain todennusta Googlen hallinnoimien sähköpostitilien kautta, joihin kuuluvat NOAA ja monien yliopistojen sähköpostitilit.
Jos ERDDAP on todennus käytössä, kuka tahansa Googlen hallinnoiman sähköpostitilin omaava voi kirjautua sisään, mutta heillä on pääsy vain niihin yksityisiin tietojoukkoon, joihin ERDDAP järjestelmänvalvoja on nimenomaisesti antanut luvan.
Katso ohjeet ERDDAP hen kirjautumisesta selaimesta tai komentosarjan kautta
kohdasta Pääsy yksityisiin tietojoukkoon ERDDAP :ssa .
Jos haluat käyttää uutta ominaisuutta etä- ERDDAP ssa, voit selvittää uuden ominaisuuden saatavuuden lähettämällä pyynnön ERDDAP :n versionumeron selvittämiseksi esim.
https://slocum-data.marine.rutgers.edu/erddap/fi/version
ERDDAP lähettää tekstivastauksen kyseisen ERDDAP :n ERDDAP versionumerolla.
Esimerkiksi:
ERDDAP_version=2.26
Jos saat
HTTP 404 Not-Found -virheilmoituksen, käsittele ERDDAP n versiota 1.22 tai sitä vanhempia.
Tai voit pyytää version_string-koodia, joka voi sisältää lisätietoja.
Esimerkiksi,
https://slocum-data.marine.rutgers.edu/erddap/fi/version_string
ERDDAP lähettää tekstivastauksen, jossa on kyseisen ERDDAP :n ERDDAP version_string.
Se on liukuluku (versionumero), jossa on valinnainen jälkiliite '_' sekä ylimääräinen ASCII-teksti (ei välilyöntejä tai ohjausmerkkejä).
Esimerkiksi:
ERDDAP_version_string=2.26_JohnsFork
Jos saat HTTP 404 Not-Found -virheilmoituksen, käsittele ERDDAP n versiota 1.80 tai sitä vanhempia.
