ERDDAP > RESTful Web Services
ERDDAP on sekä:
- Verkkosovellus
– web-sivulla on lomake, että ihmiset selaimet voivat käyttää (tässä tapauksessa tietoja, kaavioita tai tietoja tietokokonaisuuksista) .
- A RESTful verkkopalvelu
– URL että tietokoneohjelmat voivat käyttää (tässä tapauksessa, saada tietoja, kaavioita, ja tietoa tietokokonaisuuksia) .
Jokaista ERDDAP web-sivulla on lomake, jonka voi käyttää ihmisenä selaimen kanssa, on
vastaava ERDDAP verkkopalvelu, joka on suunniteltu olemaan helppo käyttää tietokoneohjelmia ja skriptejä.
Ihmiset voivat esimerkiksi käyttää tätä URL-osoitetta tehdäkseen koko tekstin etsinnän mielenkiintoisten tietoaineistojen löytämiseksi:
https://slocum-data.marine.rutgers.edu/erddap/fi/search/index.html?page=1&itemsPerPage=1000&searchFor=temperature Muuttamalla tiedostotunnisteen URL .html .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, että tietokoneohjelma tai Java Skripti voi käyttää saada saman
tietoa enemmän tietokone-ohjelma-ystävällinen muodossa, kuten
JSON
.
On olemassa monia ominaisuuksia ERDDAP joita voidaan käyttää tietokoneohjelmissa tai skripteissä
että kirjoitat. Voit käyttää niitä rakentaa muita web-sovelluksia tai verkkopalveluja
ylin ERDDAP , ERDDAP Tehkää suurin osa työstä!
Joten jos sinulla on idea paremman käyttöliittymän tietoja, ERDDAP palvelee tai verkko
sivu, joka tarvitsee helppo tapa käyttää tietoja, kehotamme sinua rakentamaan oman
verkkosovellus, verkkopalvelu tai verkkosivu ja käyttö ERDDAP Perustana.
Järjestelmäsi voi saada tietoja, kaavioita ja muita tietoja ERD S ERDDAP tai mistä
muu ERDDAP installaatiot, tai voit
perustaa oman ERDDAP palvelin ,
joka voi olla
julkisesti saatavilla tai vain yksityisesti saatavilla.
Käyttäjän yhteystietoja koskevat pyynnöt ERDDAP (esimerkiksi hakutulokset) käyttää verkon yleistä standardia pyyntöihin:
URL
Lähetetty
HTTP GET .
Tämä on sama mekanismi, jota selaimesi käyttää täytettyäsi lomakkeen
web-sivulla ja klikkaa
Lähetä Käytettävä HTTP GET , luot erityisesti muodostettu URL (johon voi sisältyä kysely) ja lähetä se mukana HTTP GET . Voit muodostaa nämä URL-osoitteet käsin ja syöttää ne
selaimesi osoitetekstikenttä (esimerkiksi
https://slocum-data.marine.rutgers.edu/erddap/fi/search/index.json?page=1&itemsPerPage=1000&searchFor=temperature )
Tai voit kirjoittaa tietokoneohjelman tai web-sivun script luoda URL, lähettää sen,
ja saada vastaus. URL-osoitteet HTTP GET valittu koska
- Niitä on helppo käyttää.
- Ne toimivat hyvin.
- Niitä tuetaan yleisesti (selaimissa, tietokonekielissä, käyttöjärjestelmässä
työkalut jne.) .
- Ne ovat perusta
Edustusvaltion siirto ( REST ) sekä
Resurssilähtöinen arkkitehtuuri ( ROA )
- Ne helpottavat World Wide Webin käyttöä suurena hajautettuna sovelluksena.
esimerkiksi
mashups AJAX hakemukset
- He ovat kansalaisuudeton
ja ERDDAP , mikä tekee järjestelmästä yksinkertaisemman.
- URL määrittää täysin tietyn pyynnön, joten voit merkitä sen selaimeesi,
Kirjoita se muistiinpanoihin, lähetä se ystävälle jne.
URL-osoitteissa jotkut merkit eivät ole sallittuja (esimerkiksi välilyöntejä) ja muut merkit
joilla on erityinen merkitys (esimerkiksi '&' erottaa avain = arvo paria kyselyssä) .
Kun täytät lomakkeen verkkosivulla ja klikkaa Lähetä, selain automaattisesti
%-koodaukset
URL:n erikoismerkit (Esimerkiksi tila muuttuu [52]) Esimerkiksi
https://slocum-data.marine.rutgers.edu/erddap/fi/search/index.html?page=1&itemsPerPage=1000&searchFor=temperature%20wind%20speed Mutta jos tietokoneesi ohjelma tai skripti tuottaa URL-osoitteita, sen on luultavasti tehtävä prosenttiosuus
Koodaus itse. Jos on, niin luultavasti kaikki muut merkit kuin A-Za-z0-9 -!.~\" () *
kyselyn arvot (osat sen jälkeen '=' merkit) on koodattava
Kuten %HH, jossa HH on merkin kaksinumeroinen heksadesimaaliarvo, esimerkiksi tila muuttuu [52].
Yllä olevan numeron 127 merkit on muunnettava UTF-8 tavuiksi, niin jokainen UTF-8 tavu on koodattava prosentteina
(kysy ohjelmoijalta apua) Ohjelmointikielillä on tähän tarvittavat välineet (esimerkiksi katso Java S
java.net.URLEncoder sekä Java Skripti
encodeURIComponent () ) ja on olemassa
sivustot, jotka prosentti encode / decode sinulle
Vaikka ihmiset käyttävät selaimia haluavat saada käyttäjien interface tuloksia (esimerkiksi
hakutulokset) HTML-dokumentteja, tietokoneohjelmat usein mieluummin saada tuloksia
yksinkertaisia, helposti jäsenneltyjä, vähemmän verbose asiakirjoja. ERDDAP voi palauttaa käyttäjän interface
tulokset taulukkona näistä yhteisistä tietokoneohjelmaystävällisistä tiedostotyypeistä:
- .csv - pilkulla erotettu ASCII tekstitaulukko.
( enemmän tiedot
)
- .htmlTable - .html-sivu, jossa tiedot ovat taulukossa.
( enemmän tiedot
)
- .itx - Igor Text -tiedosto, jossa on aalto kutakin datapalstaa varten.
( enemmän tiedot
)
- .json - Pöytämäinen Json-kansio.
( enemmän tiedot
tai
ERDDAP - erityistiedot )
- .jsonlCSV1 - \"Better than CSV\" JSON Lines -tiedosto, jonka ensimmäisellä rivillä on sarakkeen nimet.
( enemmän tiedot
)
- .jsonlCSV - \"Parempi kuin CSV\"
( enemmän tiedot
)
- .jsonlKVP - JSON Lines -tiedosto Key:Value pareilla.
( enemmän tiedot
)
- .mat - MATLAB-binaaritiedosto.
( enemmän tiedot
)
- .nc - litteä, pöytämäinen, NetCDF - Kolme binääritiedostoa.
( enemmän tiedot
)
- .nccsv - litteä, pöytämäinen, NetCDF - ASCII CSV -tiedosto.
( enemmän tiedot
)
- .nc oJson - JSON-tiedosto ( NCO - tyyliin) ainoastaan tietokokonaisuuden metatietojen kanssa (maailmanlaajuiset ominaisuudet,
mitat, ja muuttujat niiden ominaisuudet, tyyppi, ja muoto) eikä data-arvoja.
( enemmän tiedot
) . Tätä muotoa sovelletaan ainoastaan yhden tietokokonaisuuden metatietopyyntöihin.
- .tsv - välilehden erotettu ASCII tekstitaulukko.
( enemmän tiedot
)
- .xhtml - an XHTML (XML) tiedoston tiedot taulukossa.
( enemmän tiedot
)
Jokaisessa tulostaulun muodossa (paitsi .jsonlKVP , jossa sarakkeiden nimet ovat jokaisella rivillä) :
- Jokaisessa sarakkeessa on sarakkeen nimi ja yksi tietotyyppi.
- Taulukon ensimmäisellä rivillä on sarakkeen nimet.
- Seuraavilla riveillä on pyytämäsi tiedot.
Näiden tavallisen tiedoston tyyppien sisältö on myös hieman erilainen kuin .html
vastaus — se on tarkoituksella paljain luin varustettu niin, että se on helpompaa tietokoneelle
Ohjelma jonka kanssa työskennellä.
Vastausten johdonmukainen tietorakenne
Kaikki tällä sivulla kuvatut käyttäjä-yhteyspalvelut voivat palauttaa taulukon
tiedot kaikissa edellä luetelluissa yhteisissä tiedostomuodoissa. Toivottavasti osaat kirjoittaa.
Vain yksi menettely tulkita taulukko yhdessä muodossa. Sitten voit.
käyttää uudelleen tätä menettelyä minkä tahansa näistä palveluista saadun vastauksen tulkitsemiseksi. Tämä
Olisi helpompaa käsitellä ERDDAP .
.csv sekä .tsv Yksityiskohdat
- Jos .csv-tiedoston datum-tiedostossa on sisäiset kaksinkertaiset lainausmerkit tai pilkut, ERDDAP seuraa
.csv erittely tiukasti: se asettaa kaksinkertainen lainausmerkkejä noin datum ja kaksinkertaistuu
sisäiset kaksinkertaiset lainaukset.
- Erikoismerkit csv tai .tsv tiedosto on koodattu kuten
JSON
backslash-koodatut merkit:
\n (uusi rivi) \\\\ (takaisku) , \f (formfeed) ,\t (välilehti) \r (kuljetuspaluu) tai \\ u Hhhhh Syntaksi.
jsonp
Pyynnöt .json tiedostoihin voi nyt sisältyä valinnainen
jsonp
pyytää
lisätään \"& .json p= funktioName \"kyselyn loppuun asti. Periaatteessa tämä kertoo
ERDDAP lisätään \" funktioName (\"vastauksen alkuun ja \") \"
vastauksen loppu. Ensimmäinen luonne funktioName on oltava ISO 8859 -kirjain tai \" .\"
Jokaisen valinnaisen myöhemmän merkin on oltava ISO 8859 -kirjain, \" ,\" numero tai \".\"
Jos kyselyä ei alun perin ollut, jätä pois \"&\" kyselyssä.
ruudukko ja tabledap Tarjoa erilaisia tiedostotyyppejä
Edellä luetellut tiedostotyypit ovat tiedostotyyppejä ERDDAP voi käyttää vastata
käyttäjien väliset pyynnöt (esimerkiksi hakupyynnöt) . ERDDAP tuet
eri tiedostotyypit tieteellisiä tietoja (Esimerkiksi satelliitti ja poiju
tiedot) pyynnöt (ks.
griddap sekä
tabledap asiakirjat) .
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 on nämä URL-yhteyspisteet tietokoneohjelmia:
- Saada luettelo tärkeimmät resurssin käyttöosoitteet , käyttö
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saada nykyisen luettelon kaikki tietokokonaisuudet , käyttö
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saada metatiedot tietyn tietokokonaisuuden osalta
(muuttujien ja niiden ominaisuuksien luettelo) , käyttö
https://slocum-data.marine.rutgers.edu/erddap/fi /info datasetID /indeksi .fileType
tai lyhyt URL-lomake
https://slocum-data.marine.rutgers.edu/erddap/fi /info datasetID .fileType
esimerkiksi
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.ncoJson,
.tsv, or
.xhtml.
- Saada tuloksia täydellinen haku tietokokonaisuuksia varten
(käytetään "searchFor=wind%20speed" esimerkkinä) , käyttö
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
(Ohjelma tai skripti voi tarvita
%-encode
kyselyn arvo.)
Tai käytä
OpenSearch 1. 1 standardi tehdä koko tekstin haku tietokokonaisuuksia.
- Saada tuloksia edistyneet haut tietokokonaisuuksia varten
(käytetään "searchFor=wind%20speed" esimerkkinä) , käyttö
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
Mutta kokeile
Tarkennettu Haku selaimessa selvittää kaikki valinnaiset parametrit.
(Ohjelma tai skripti voi tarvita
%-encode
kyselyn arvo.)
- Saadaksesi luettelon categoryAttributes (esimerkiksi laitos, long_name , standardi nimi) , käyttö
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saadaksesi luettelon tiettyyn kategoriaanAttribuutti (käytetään esimerkkinä \"standard name\") , käyttö
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saadaksesi luettelon Tiedostot tietyssä kategoriassa (käytetään esimerkkinä \"standard name=time\") , käyttö
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- Saada muuttujan metatiedot-attribuuttiehdotukset , lähetä JSON (Sisältö-tyyppi: hakemus/json) Jälkipyyntö
sisältää ncoJson tyylimuuttujat, joilla on ominaisuuksia, esimerkiksi:
{\"variables\": {\"air temp\": {\"attribuutit\": {\"name\": \"Air temp,\" \"yksiköt\": \"degC\"}}}}}
- https://slocum-data.marine.rutgers.edu/erddap/fi /suggestVariableAttributes
- Saadaksesi nykyisen luettelon kaikista tietyn protokollan kautta saatavilla olevista tietojoukoista,
- Griddap:
käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- tabledap :
käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.jsonlKVP,
.mat,
.nc,
.nccsv,
.tsv, or
.xhtml.
- WMS: käytä
.csv,
.htmlTable,
.itx,
.json,
.jsonlCSV,
.jsonlCSV1,
.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.31.1
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.31.1_JohnsFork
Jos saat HTTP 404 Not-Found -virheilmoituksen, käsittele ERDDAP n versiota 1.80 tai sitä vanhempia.
