# Map feeds

Weedmanager provides a range of map feeds in OGC (Open Geospatial Consortium) formats which can be linked directly into GIS tools such as ArcGIS, Google Earth and Google Maps, QuantumGIS etc.

To access the feeds you first need to generate an API key.

# Generating an API key

In the **My account** section of Weedmanager, you can generate an API key that’s associated with your user account. It can only be used for map feeds (which are read-only), and it can be changed any time by generating a new key, which will disable any previously used keys.

[![image-1726204685547.png](https://help.groundtruth.co.nz/uploads/images/gallery/2024-09/scaled-1680-/image-1726204685547.png)](https://help.groundtruth.co.nz/uploads/images/gallery/2024-09/image-1726204685547.png)

# Accessing map feeds

Map feed addresses are in the format:  
  
`https://io.weedmanager.nz/geo/wm/wfs/<span style="color: #ff0000;"><strong>apikey</strong></span>/<span style="color: #0000ff;"><strong>project_id</strong></span>`  
and   
`https://io.weedmanager.nz/geo/wm/wfs/<span style="color: #ff0000;"><strong>apikey</strong></span>/<span style="color: #0000ff;"><strong>project_id</strong></span>`  
  
for WFS and WMS feeds respectively.

The Project ID is the last part of the URL when you select your project in Weedmanager.   
i.e. when you select the project after logging in, the URL will look something like `https://weedmanager.nz/group/<strong><span style="color: #ff0000;"><span style="color: #0000ff;">123456</span></span></strong>`, and in this case, the Project ID will be 123456.

**Note:** Some of the map feeds apply to all the projects you are a member of. If you are using those feeds, you still need to select a default project. It doesn’t matter which one.

So for a test user and project the WFS feed looks like this:  
`<a href="https://io.weedmanager.nz/geo/wm/wfs/">https://io.weedmanager.nz/geo/wm/wfs/</a><span style="color: #ff0000;">35GElj7FEyGB-gpalO5ptgcEjxmNe7QaOiJNbEPZmSU</span>/<strong><span style="color: #0000ff;">123456</span></strong>`

(you must [generate your own key](https://help.groundtruth.co.nz/books/weed-manager-user-guide/page/generating-an-api-key "Weed Manager User Guide") under the **My Account** section of the Weedmanager website)

You can paste these URLs into your GIS system and it will show you the available layers.

#### The layers currently available are:

- **default-project-tracks**   
    All tracks from the project specified in the URL
- **default-project-weeds-all-geometries**   
    All current weeds from the project specified in the URL (combined geometries - only useful for GIS tools that can handle multiple geometry types)
- **default-project-weeds-linestrings**   
    All current weed lines from the project specified in the URL
- **default-project-weeds-points**   
    All current weed points from the project specified in the URL
- **default-project-weeds-polygons**   
    All current weed polygons from the project specified in the URL
- **default-project-work-areas**   
    Work areas from the project specified intheURL
- **my-projects-tracks**   
    All tracks from the projects you have access to
- **my-projects-weeds-all-geometries**  
    All current weeds from from the projects you have access to (combined geometries - only useful for GIS tools that can handle multiple geometry types)
- **my-projects-weeds-linestrings**   
    All current weed lines from the projects you have access to.
- **my-projects-weeds-points**   
    All current weed points from the projects you have access to
- **my-projects-weeds-polygons**   
    All current weed polygons from the projects you have access to
- **my-projects-work-areas**  
    Work areas from the projects you have access to

##### Notes

- The WFS server is set to return a maximum of 10k features per page request. Therefore you must set a page size value smaller than that. We suggest 5k to begin with.

# Downloading shape files, CSV, linking into Google Earth etc

The map server allows access to WGS 84 and NZTM projections and can also output in many different formats with:

`https://io.weedmanager.nz/geo/wm/wfs/<strong><span style="color: #ff0000;">apikey</span></strong>/<strong><span style="color: #0000ff;">project_id</span></strong>?service=WFS&version=1.0.0&request=GetFeature&typeName=<strong><span style="color: #ff0000;">layer</span></strong>&outputFormat=<span style="color: #0000ff;"><strong>format</strong></span>`

Output formats:

<table class="colwidths-given docutils align-default" id="bkmrk-gml2-outputformat%3Dgm"><tbody><tr class="row-even"><td>GML2

</td><td>`<span class="pre">outputFormat=GML2</span>`

</td></tr><tr class="row-odd"><td>GML3

</td><td>`<span class="pre">outputFormat=GML3</span>`

</td></tr><tr class="row-even"><td>Shapefile

</td><td>`<span class="pre">outputFormat=shape-zip</span>`

</td></tr><tr class="row-odd"><td>JSON

</td><td>`<span class="pre">outputFormat=application/json</span>`

</td></tr><tr class="row-even"><td>JSONP

</td><td>`<span class="pre">outputFormat=text/javascript</span>`

</td></tr><tr class="row-odd"><td>CSV

</td><td>`<span class="pre">outputFormat=csv</span>`

</td></tr><tr><td>KML

</td><td><span class="pre">`outoutFormat=application/vnd.google-earth.kml+xml`</span>

</td></tr></tbody></table>

e.g. to get a **shapefile** of trap locations:

`https://io.weedmanager.nz/geo/wm/wfs/<strong><span style="color: #ff0000;">apikey</span></strong>/<strong><span style="color: #0000ff;">project_id</span></strong>?service=WFS&version=1.0.0&request=GetFeature&typeName=<strong>wm:default-project-weeds-points</strong>&outputFormat=<strong>shape-zip</strong>`

**KML** (you can link this directly into Google Earth):

`https://io.weedmanager.nz/geo/wm/wfs/<strong><span style="color: #ff0000;">apikey</span></strong>/<strong><span style="color: #0000ff;">project_id</span></strong>?service=WFS&version=2.0.0&request=GetFeature&typeName=<strong>wm:default-project-weeds-points</strong>&outputFormat=<strong>application/vnd.google-earth.kml+xml</strong>`

**CSV**:

`<strong>https://io.weedmanager.nz/geo/wm/wfs/<span style="color: #ff0000;">apikey</span>/<span style="color: #0000ff;">project_id</span></strong>?service=WFS&version=2.0.0&request=GetFeature&typeName=<strong>wm:default-project-weeds-points</strong>&outputFormat=<strong>csv</strong>`

You can also view features directly in **OpenLayers**:

`https://io.weedmanager.nz/geo/wm/wfs/<strong><span style="color: #ff0000;">apikey</span></strong>/<strong><span style="color: #0000ff;">project_id</span></strong>?service=WMS&version=1.1.0&request=GetMap&layers=<strong>wm:default-project-weeds-points</strong>&bbox=174.94,-41.5,174.95,-41&width=708&height=768&srs=EPSG:4326&format=<strong>application/openlayers</strong>`

##### **Notes:**

The WFS server is set to return a maximum of 10k features per request. If you have more that, you will need to use software (e.g. ArcGIS Pro, or QuantumGIS) to page requests, or include `count` and `startindex` parameters . [See the WFS specification.](https://www.ogc.org/standards/wfs) <svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg>

The shapefile format has a number of limitations - see the [Geoserver documentation](https://docs.geoserver.org/latest/en/user/services/wfs/outputformats.html#shapefile-output). Datetime fields are not supported - only the date will be included.