Sări la conținutul principal

Servicii web GeoServer

Qarta oferă acces direct la o instanță GeoServer complet funcțională prin servicii web conforme cu OGC (WMS și WFS). Aceste servicii vă permit să interacționați cu straturi geospațiale publicate în GeoServer folosind protocoale standard din industrie.

Ce este GeoServer?​

GeoServer este un server open-source pentru partajarea datelor geospațiale. Implementează standarde OGC (Open Geospatial Consortium):

  • WMS (Web Map Service) — redă dale de hartă cu stil
  • WFS (Web Feature Service) — interogare caracteristici geografice brute

Proxy-ul Qarta se află în fața GeoServer-ului, adăugând autentificare (cheie API) și făcând aceste servicii accesibile ca parte a platformei unificate Qarta.

Autentificare​

Toate punctele finale GeoServer sunt accesate prin autentificarea standard Qarta:

Authorization: YOUR_API_KEY

Transmiteți cheia API în antetul Authorization așa cum ați face-o pentru orice alt punct final Qarta. Cheia API este validată, apoi cererea este transmisă mai departe la GeoServer.

Cheia API trebuie să rămână pe server

Bibliotecile de hartă bazate pe browser (Leaflet, OpenLayers, Mapbox GL) nu pot seta antetele HTTP personalizate pe cereri de dale WMS/WFS - este o restricție de securitate a browserului. Nu expuneți cheia API în cod pe partea clientului.

Pentru aplicații web care încorporează dale WMS sau interogare date WFS, rulați un proxy pe backend care atașează cheia API înainte de a transmite cererile mai departe la Qarta. Consultați Ghidul Proxy GeoServer pentru un exemplu complet și executabil în Python.

URL de bază​

Toate serviciile web sunt accesate prin calea de bază /graph/layers/:

https://graph.quarticle.ro/graph/layers/

Convenția de denominire a straturilor​

Straturile în GeoServer urmează formatul WORKSPACE:layername:

  • WORKSPACE: în mod obișnuit GRAPHRASTER pentru straturi bazate pe imagistică
  • layername: stratul specific (de ex., light_pollution, temperature, elevation)

Exemplu: GRAPHRASTER:light_pollution

Sisteme de coordonate​

Dale de hartă (WMS)​

Dalele de hartă sunt de obicei cerute în EPSG:3857 (Web Mercator), proiecția web standard:

srs=EPSG:3857
bbox=975947.9771,6657970.9118,1533632.5355,7037098.5720

Date de caracteristici (WFS)​

Caracteristicile brute sunt de obicei returnate în EPSG:4326 (WGS84, lat/lon), standardul global:

srsName=EPSG:4326

Servicii disponibile​

WMS — Web Map Service (5 operații)​

Redă dale de hartă cu stil din straturi GeoServer. Utilizați pentru a:

  • Afișa straturi pe o hartă interactivă (Leaflet, OpenLayers, Mapbox)
  • Genera imagini de hartă statice
  • Interoga caracteristici la o locație de pixel pe o hartă
  • Recupera metadate straturilor și legende

👉 Citiți ghidul WMS

WFS — Web Feature Service (1 operație)​

Interogați caracteristici geografice brute din straturi GeoServer. Utilizați pentru a:

  • Descărca caracteristici ca GeoJSON sau GML
  • Filtra după casetă de delimitare, ID caracteristică sau expresie CQL
  • Selectați proprietăți specifice
  • Integrați date de caracteristici în aplicații

👉 Citiți ghidul WFS

Cazuri de utilizare​

Vizualizare hartă​

Încorporați straturi WMS ca suprapuneri în hărți web pentru a afișa date geospațiale cu stil alături de alte elemente de hartă.

👉 Consultați: Caz de utilizare vizualizare hartă

Interogare caracteristici​

Recuperați date brute de caracteristici geografice pentru analiză, export sau procesare descendent.

👉 Consultați: Caz de utilizare interogare caracteristici

Caracteristici specifice GeoServer​

Filtre CQL​

GeoServer extinde standardul OGC cu CQL (Common Query Language) pentru filtrare puternică de atribute și spațiale:

cql_filter=population > 1000000 AND type = 'urban'
cql_filter=INTERSECTS(geometry, POINT(-74.0060 40.7128))

Styled Layer Descriptor (SLD)​

Definiți stiluri de hartă personalizate folosind SLD, un limbaj de stil bazat pe XML, sau faceți referință la stiluri pre-definite publicate în GeoServer.

Suport temporal​

Unele straturi pot accepta interogări temporale folosind parametrul time:

time=2023-01-01T00:00:00Z
time=2023-01-01T00:00:00Z/2023-12-31T23:59:59Z

Securitate și limite​

  • Autentificare: Toate punctele finale serviciilor web necesită cheia API
  • Acces date: Doar straturile publicate în GeoServer sunt accesibile
  • IP whitelisting: Poate fi aplicat la nivel GeoServer (contactați suportul dacă este necesar)

Pașii următori​