TNRIS Mapserver

Service URLs: How To

All service URLs are constructed with the https://mapserver.tnris.org/ domain and a series of query parameters which determine which service (mapfile) and the type of service requested. Different service types require differing query parameters to work. Various services (mapfiles) differ in which service types are available - explore the service's (mapfile) capabilities URLs to determine which services are available for that mapfile.

Service Details & Capabilities:
For HTML template page use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>
For WFS XML use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&REQUEST=GetCapabilities&SERVICE=WFS
For WMS XML use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&REQUEST=GetCapabilities&SERVICE=WMS

WMS (Web Map Service) service:
For geo software like QGIS/ESRI use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>
For web maps/applications use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&bbox={bbox-epsg-3857}&format=image/png&service=WMS&version=1.1.1&request=GetMap&srs=EPSG:3857&transparent=true&width=256&height=256&layers=<__comma separated list of specific layer names__>
Note: The URL swaps & (versus ?) and all text-string literal layer name (versus integer 0) for mapserver unlike ArcGIS WMS Services.

XYZ Tile service:
https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&mode=tile&tilemode=gmap&tile={x}+{y}+{z}&layers=all&map.imagetype=png

UTF Grid (Raster Interoperability) service:
https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&mode=tile&tilemode=gmap&tile={x}+{y}+{z}&layers=all&map.imagetype=utfgrid

MVT (Mapbox Vector Tiles) service:
https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&mode=tile&tilemode=gmap&tile={x}+{y}+{z}&layers=all&map.imagetype=mvt

WFS (Web Feature Service) service:
https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&SERVICE=WFS&VERSION=2.0.0
For the actual data in XML format within app/browser use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&SERVICE=WFS&VERSION=2.0.0&REQUEST=GetFeature&TYPENAMES=<__comma separated list of specific layer names__>
For the actual data in GEOJSON format within app/browser use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&SERVICE=WFS&VERSION=2.0.0&REQUEST=GetFeature&TYPENAMES=<__specific layer 'NAME' within mapfile__>&outputformat=geojson
Note: GEOJSON query parameter only works for a single layer.
For the actual data reprojected in WGS84 use https://mapserver.tnris.org/?map=/<__mapfile path & filename__>&SERVICE=WFS&VERSION=2.0.0&REQUEST=GetFeature&TYPENAMES=<__comma separated list of specific layer names__>&SRSNAME=EPSG:4326
Note: Mapfiles are configured in default projection EPSG:3857, but optionally available to reproject on-the-fly as EPSG:4326. This query parameter works with both XML and GEOJSON GetFeature requests.

Further Points of Notice:

• All services (except WFS which alternatively uses the query paramater TYPENAMES), utilize the URL query parameter &layers=all to retrieve data for all mapfile layers. The value all can be replaced with one or more specific layer 'NAME's from within the mapfile to only retrieve data for that/those layer(s). Multiple layer 'NAME's need to be a space separated list. (i.e. &layers=CountyBoundaries or &layers=CountyBoundaries Labels)
• WFS Service GetFeature requests additionally support Filter Encoding within URLs. (i.e. &Filter=<Filter><PropertyIsEqualTo><PropertyName>___fieldname___</PropertyName><Literal>___fieldvalue___</Literal></PropertyIsEqualTo></Filter>)
• Many specific layers within tnris_mapfiles/ pathed mapfiles apply native SQL queries on the source dataset. These layers require a specific query parameter (custom to that layer and properly formatted) within the URL in order to return data successfully. Because of this, the layer will not return results for WMS or WFS services when used in GIS software like QGIS. Applying this query in a "XYZ Tile service" in GIS software will still work though. (i.e. https://mapserver.tnris.org/?map=/tnris_mapfiles/area_type.map&SERVICE=WFS&VERSION=2.0.0&REQUEST=GetFeature&TYPENAMES=county_query&outputformat=geojson&SRSNAME=EPSG:4326&Counties=Zapata','Starr)