Ulkoiset ominaisuuspalvelut Fabric Mapsissa

Fabric Maps voi yhdistää ulkoisiin ominaisuuspalveluihin ja renderöidä vektoridatansa karttakerroksina. Ulkoinen ominaisuuspalvelu tarjoaa maantieteellisiä piirteitä, kuten pisteitä, viivoja ja monikulmioita, sekä attribuutteja, jotka kuvaavat näitä piirteitä.

Yhdistämällä ulkoiseen ominaisuuspalveluun voit visualisoida etäisännöityä tilallista dataa ilman, että kopioit sitä ensin järvimajaan tai tapahtumataloon. Fabric Maps kysyy palvelua, hakee valitut ominaisuudet ja attribuutit ja renderöi tulokset vektoridatakerroksena.

Fabric Maps tukee seuraavia ulkoisia ominaisuuspalveluprotokollia:

• Verkkoominaisuuspalvelu (WFS)
• OGC API - Ominaisuudet
• Esri-ominaisuuspalvelu

Näihin protokolliin pääsee Geospatial Web Services -yhteystyypin kautta, yhdessä WMS:n ja WMTS:n kanssa. Luo pilviyhteys Hallinnoi yhteyksiä ja yhdyskäyttimiä -kohtaan ja lisää yhteys karttaan kartan Resurssienhallinnan Ulkoiset lähteet -välilehdeltä.

Mikä on ulkoinen ominaisuuspalvelu?

Ulkoinen ominaisuuspalvelu on verkkopohjainen paikkatietoinen API, joka julkaisee yksittäisiä maantieteellisiä piirteitä. Jokainen ominaisuus sisältää:

• Geometria, joka määrittelee piirteen sijainnin ja muodon pisteenä, viivana tai monikulmiona.
• Attribuutit, jotka tarjoavat tietoa ominaisuudesta, kuten nimen, kategorian, tilan, mittauksen tai päivämäärän.

Esimerkiksi ominaisuuspalvelu voi julkaista ajoneuvojen sijainnit pisteinä, tiet viivoina tai hallinnolliset rajat monikulmioina. Fabric Maps käyttää geometriaa piirtääkseen jokaisen piirteen ja tekee valitut attribuutit saataville tyylittelyyn, suodatuseen, etiketteihin, merkintöihin ja työkaluvihjeisiin.

Palvelu ja sen tiedot pysyvät kartan ulkopuolella. Kartta tallentaa viittauksen yhteyteen ja konfiguraatioon, joka tarvitaan datan hakemiseen ja näyttämiseen.

Tuetut ominaisuuspalveluprotokollat

Seuraava taulukko tiivistää, miten Fabric Maps toimii kunkin tuetun protokollan kanssa.

Miten ulkoiset ominaisuuspalvelut toimivat Fabric Mapsissa

Kun lisäät karttaan ulkoisen ominaisuuspalvelun, Fabric Maps:

1. Käyttää olemassa olevaa yhteyttä tai luo yhteyden etäpäätepisteeseen.
2. Löytää palvelun julkaisemat ominaisuuskerrokset tai kokoelmat.
3. Lukee saatavilla olevat metatiedot, mukaan lukien geometriatyypit, kentät, tietuerajat ja tuetut kyselyominaisuudet.
4. Voit konfiguroida palvelinpuolen kyselyn ja valita haettavat kentät.
5. Pyytää yhteensopivuusominaisuuksia, mukaan lukien lisätulossivut, kun niitä tuetaan ja vaaditaan.
6. Renderöi palautetut ominaisuudet vektoridatakerroksena.

Oletusvisualisointi perustuu palvelun palauttamaan geometriaan:

Kun kerros on lisätty, voit konfiguroida tuetut vektorikerrosasetukset, kuten tyylitys, etiketit, merkinnät, työkaluvihjeet, näkyvyys ja karttakerroksen suodattimet. Lisätietoja löytyy kohdasta Customize a map and Data filtering in Fabric Maps.

WFS- tai OGC-rajapinnalle – Sisältää sekoitetun geometrian vasteen, Fabric Maps luo yhden tietokerroksen. Kerroksen raportoitu geometriatyyppi on tuntematon , koska yksittäinen tyyppi ei kuvaa sitä. Pistepiirteet käyttävät kuplakerrosta, viivapiirteet viivakerrosta ja polygonipiirteet polygonikerrosta ilman ekstruusiota. Jos otat dataohjatun tyylin käyttöön, Fabric Maps näyttää geometriatyyppien merkinnät datakerroksen paneelissa. Klusterointi ei ole mahdollista sekageometrisille kerroksille.

Ulkoiset ominaisuuspalvelukerrokset tukevat kategoria- ja arvoalueen datalähtöistä muotoilua.

Kerrosten ja kokoelman löytäminen

Fabric Maps listaa kelvolliset ominaisuuskerrokset tai kokoelmat Explorerin ulkoiset lähteet -osiossa linkin alla. Käytettävissä oleva hierarkia riippuu palvelun paljastamasta protokollasta ja metatiedoista.

Yhteyden päivittäminen hakee viimeisimmät palvelun metatiedot, mukaan lukien uudet kentät, kerrokset tai kokoelmat. Nämä muutokset eivät välttämättä ilmene automaattisesti. Käyttääksesi uutta kenttää, päivitä yhteys, lisää lähdekerros uudelleen ja valitse kenttä.

Palvelun palauttamat metatiedot voivat sisältää:

• Näyttönimet ja tunnisteet
• Geometriatyypit
• Attribuuttikentät ja tietotyypit
• Tilalliset laajuudet
• Suurin ennätysmäärä
• Tuetut suodatus-, lajittelu-, sivutus- ja ajalliset ominaisuudet

Saatavilla olevat konfiguraatiovaihtoehdot voivat vaihdella palveluittain, koska Fabric Maps käyttää kunkin päätepisteen mainostamia ominaisuuksia.

Lähdekyselyt

Ennen kuin lisäät ominaisuuskerroksen karttaan, voit konfiguroida lähdekyselyn, joka rajoittaa etäpalvelusta haettujen tietueiden ja kenttien määrää. Kyselyn käsittely palvelimella voi vähentää Fabric Mapsiin siirrettävän datan määrää ja keskittyä kerroksessa skenaarioosi sopiviin ominaisuuksiin.

Lähdekyselyssä käytettävissä olevat kentät ja operaattorit riippuvat valitusta protokollasta ja palvelun mainostamista ominaisuuksista. Lähdekyselyt tukevat lähtökentän valintaa ja voivat tukea ajallista suodatusta. Fabric Maps tulkitsee päivämäärä/aika-arvot UTC-muodossa RFC 3339 -muodossa.

Fabric Maps validoi kyselyn valittua palvelua vastaan. Jos kenttää, arvoa tai operaattoria ei tueta, konfigurointikokemus näyttää virheen, jota voit käyttää kyselyn muokkaamiseen.

Et voi palata lähdekyselyn käyttöliittymään muokkaamaan kyselyä kerroksen lisäämisen jälkeen. Eri lähdekyselyehtojen käyttämiseksi lisää lähdekerros uudelleen ja konfiguroi uusi kysely.

Fabric Maps johtaa automaattisesti rajaavan laatikon karttanäkymästä, kun se pyytää ominaisuuksia. Rajaava laatikko ei ole näkyvissä eikä konfiguroitavissa lähdekyselyn käyttöliittymässä. Käyttäjät eivät voi syöttää koordinaatteja tai valita aluetta tilallisen kyselyn ehtona.

Lähdekyselyt ja karttakerroksen suodattimet

Lähdekyselyt ja karttakerroksen suodattimet rajoittavat dataa eri vaiheissa:

Käytä lähdekyselyä vähentääksesi etäpalvelusta pyydettyä dataa. Käytä karttakerroksen suodatinta, kun karttakehittäjien tai katsojien täytyy interaktiivisesti tarkentaa palautettua dataa. Lisätietoja karttakerroksen suodattimista löytyy kohdasta Data Filtering in Fabric Maps.

Ulkoiset ominaisuuspalvelukerrokset tukevat kategorisia, numeerisia alueita, Boolen ja päivämäärä/aikakarttakerroksen suodattimia. Useat suodattimet käyttävät AND logiikkaa. Lukitut suodattimet, muokkaus- ja katselutilakäyttäytyminen sekä suodattimen pysyvyys toimivat samalla tavalla WFS-, OGC API- Features- ja Esri Feature Service -kerroksissa.

Sivutus ja tulosrajoitukset

Ominaisuuspalvelut voivat rajoittaa, kuinka monta tietuetta ne palauttavat yhdessä vastauksessa. Fabric Maps käyttää automaattisesti palvelun mainostamaa sivutuskonfiguraatiota saadakseen seuraavat tulokset. Sivutus on läpinäkyvää, eikä rakentajat voi määrittää sivun kokoa tai sivutuskäyttäytymistä.

Fabric Maps renderöi jopa 100 000 ominaisuutta per kerros. Jos lähdekysely palauttaa lisää ominaisuuksia, Fabric Maps renderöi ensimmäiset 100 000 ja näyttää varoituksen Kerrosasetukset-paneelissa. Tarkenna lähdekyselyä vähentääksesi tulosjoukkoa.

Jos sivupyyntö epäonnistuu, Fabric yrittää sen uudelleen jopa kolme kertaa. Jos pyyntö epäonnistuu, Fabric Maps näyttää viestin Pyyntö epäonnistui; joitakin ominaisuuksia puuttuu. Päivitä yrittääksesi uudelleen.

Tallennettu konfiguraatio

Kun tallennat kartan, Fabric Maps säilyttää ulkoisen kerroskonfiguraation, mukaan lukien:

• Yhteysviittaus
• Valittu ominaisuuskerros tai kokoelma
• Lähdehaku
• Valitut lähtökentät
• Kerrostailu ja legenda
• Näkyvyys
• Kerrosjärjestys

Kun avaat kartan uudelleen, Fabric Maps käyttää tallennettua konfiguraatiota hakeakseen ja renderöidäkseen kerroksen.

Kaksinkertaiset kerrokset viittaavat samaan tietolähteeseen, yhteyteen, lähdekyselyyn ja valittuihin lähtökentteihin. Karttakerroksen suodattimet ja visuaaliset asetukset ovat toisistaan riippumattomia jokaiselle kaksoiskappaleelle. Et voi muokata lähdekyselyä tai tuloskenttiä, kun olet lisännyt kerroksen tässä julkaisussa.

Päivitä ulkoiset ominaisuuspalvelut

Fabric Maps tarjoaa kaksi päivitystoimintoa muokkaustilassa:

• Päivitä yhteys ulkoisissa lähteissä hakeaksesi viimeisimmät palvelun metatiedot, mukaan lukien uudet kentät, kerrokset tai kokoelmat. Käyttääksesi uutta kenttää, lisää lähdekerros uudelleen ja valitse kenttä.
• Päivitä karttaalkio kysyäksesi tallennettuja kerroksia nykyisistä tiedoista. Tämä toiminto ei muuta tallennettua lähdekoodikyselyä.

Katsojat eivät voi päivittää ulkoisten ominaisuuspalveluiden tietoja tässä julkaisussa. Tallennetut ulostulokentät, tyyli, legendat, näkyvyys ja kerrosjärjestys säilyvät päivityksen jälkeen.

Todennus ja pääsy

Ulkoiset ominaisuuspalvelut voivat vaatia tunnuksia Fabric-kartan avaamiseen tai muokkaamiseen tarvittavien oikeuksien lisäksi.

Esri Feature Service API -avaimen todennuksessa käytä token API-avainparametrin nimeä.

Fabric tallentaa tunnistetiedot pilviyhteyteen. Katsojat eivät tarvitse erikseen jaettua yhteyttä ulkoisen datan renderöintiin. Jos Fabric Maps ei pysty hakemaan kelvollisia yhteystietoja tai tavoittamaan palvelua, se näyttää virheen, joka kertoo, ettei palveluun ole päästy yhteyttä.

Ulkoiset ominaisuuspalvelut ja kuvapalvelut

Ulkoiset ominaisuuspalvelut palauttavat vektorigeometrioita ja attribuutteja. WMS- ja WMTS-palvelut palauttavat renderöityjä rasterikuvia tai laattoja. Valitse lähdetyyppi, joka vastaa karttasi vaatimaa dataa ja vuorovaikutuksia.

Lisätietoja ulkoisista kuvista löytyy kohdasta Create layers using WMS- ja WMTS-kuvalähteet Fabric Mapsissa.

Protokollaan liittyvät näkökohdat

WFS

• Löydä palvelun ominaisuuksista saatavilla olevat kerrokset.
• Käytä WFS:n versioita 1.0.0, 1.1.0 tai 2.0.0.
• Kun palvelu mainostaa useita tuettuja versioita, Fabric Maps käyttää uusinta versiota.
• WFS-palvelun on tuettava GeoJSON-vastauksia.
• Tue sekoitetun geometrian vasteita yhdessä kerroksessa.

OGC API - Ominaisuudet

• Järjestä saatavilla olevat tiedot kokoelmiin.
• Edistyneet attribuutti- ja ajalliset operaatiot riippuvat palvelun mainostamista yhteensopivuusluokista.
• Tue sekoitetun geometrian vasteita yhdessä kerroksessa.
• Fabric Maps käyttää vain valittujen päätepisteiden tukemia ominaisuuksia.

Esri-ominaisuuspalvelu

• Valitun kerroksen on tuettava GeoJSON-lähtöä.
• Älä tue sekoitetun geometrian vasteita.
• Fabric Maps hyväksyy geometrian M- tai Z-koordinaattiarvoilla ja jättää ylimääräiset ulottuvuudet huomiotta.

Rajoitukset ja huomioitavat seikat

• Ulkoisten ominaisuuksien palveluiden integrointi on vain luku -tilassa. Vastaanotto, ominaisuuksien editointi ja takaisinkirjoitus eivät ole tuettuja.
• Kyselyominaisuudet riippuvat etäpalvelun mainostamien ominaisuuksien mukaan.
• Fabric Maps pyytää ominaisuuksia EPSG:4326-muodossa, koordinaatit pituus- ja leveysastejärjestyksessä. Palvelut, jotka julkaisevat dataa toisessa koordinaattiviitejärjestelmässä, ovat tuettuja, jos palvelu pystyy uudelleenprojisoimaan datan muotoon EPSG:4326. Jos palvelu ei pysty uudelleenprojisoimaan dataa, esimerkiksi kun kerroksen koordinaatistosta puuttuu EPSG-auktoriteettikoodi, kerros ei lataudu.
• Antimeridiaanin ylittäviä rajalaatikoita ei tueta.
• Ominaisuuksia, joiden geometria on geometriakokoelma, ei renderöidä. Muut tuetut ominaisuudet samassa kerroksessa renderöityvät normaalisti.
• Klusterointi ei ole mahdollista sekageometrisille kerroksille.
• WFS- ja Esri-ominaisuuspalvelukerrosten on tuettava GeoJSON-lähtöä.
• GML-vastausmuotoja ei tueta tässä julkaisussa.
• Fabric Maps jättää huomiotta M- ja Z-mitat Esri Feature Service -geometriassa.
• Kerros voi renderöidä jopa 100 000 ominaisuutta.
• Karttakohde voi viitata jopa 100 ulkoiseen yhteyteen WMS:N, WMTS:N, WFS:N, OGC API - Featuresin ja Esri Feature Servicen kautta.
• Vain julkisen internetin kautta saavutettavia palveluita tuetaan. Yksityiset päätelaitteet, paikalliset dataportit, virtuaaliverkon dataportit ja muut hallitut yksityisverkkovaihtoehdot eivät ole tuettuja.
• Saatavuus ja kyselyjen vasteaika riippuvat etäpalvelusta ja verkkoyhteydestä.

Seuraavat vaiheet

Tyylivaihtoehtoja varten katso Muokkaa karttaa.