A step-by-step guide for connecting to LDS Web Feature Services (WFS) in ArcGIS Desktop.
For more help with ArcGIS you can consult the official ArcGIS support documentation.
Accessing LDS web services
The first step in accessing LDS web services is to create a web services or API key. These keys are codes (such as abcdefgh123456789) unique to each LDS user, and are used to simplify the process of accessing web services.
The following process is performed using ArcGIS Desktop10.5
Tip: Setting a limit on your WFS request
Some LDS layers (e.g. the Primary Parcels layer) are too big to load in ArcMap without first setting a limit. Often if you won't set a limit and try to load large LDS layers you may encounter a HTTP 504 timeout error.
There are a few ways to set a limit within ArcGIS, including putting a scale dependency on the display of the layer or by setting a maximum number of features that will be requested (which is explained as part of the step-by-step progress).
You can also create a custom filter to limit the WFS request, for example, by feature type or bounding box extent. See our documentation on WFS filtering. You can find more information about these filtering options on our page about WFS related timeout errors.
Set a scale dependency
Because ArcMap normally tries to display layers as soon as they’re added to the tree, it can be a good idea to first add a Group Layer, set a scale dependency on it, and then add the WFS layer to the group. Click OK
Before you start
Before you can use WFS in ArcGIS you need to ensure that the Data Interoperability extension is installed. If it is, you’ll see an Interoperability Connections folder in the Catalog tree. Although this is an optional licensed extension, the WFS functionality is free.
- To begin the process of accessing LDS WFS, double click Add Interoperability Connection:
- Click the arrow button in the Format field to open the FME Reader Gallery:
- Select WFS and click OK:
- Paste the WFS URL for the LINZ Data Service in the following format:https://data.linz.govt.nz/services;key=<your_api_key>/wfs?service=WFS&request=GetCapabilities
This URL will provide you with a listing of all WFS-enabled datasets on the LINZ Data Service. You can also create connections to individual datasets. See the Services tab of any vector dataset, for the layer-specific WFS URL. For example, the following WFS URL is for the NZ Place Names (NZGB) dataset:
Important: The default version for LDS Web Feature Services is WFS 2.0. You can choose an alternative WFS version to suit your version of ArcGIS from the Parameters option. For versioning help, see our guides to versioning and axis orders.
Then click Parameters...
- Under Constraints click the ... button next to the Feature Types field to get a list of all the LINZ Data Service WFS layers:
- To filter the list, type part of the layer name you’re interested in. Use keywords such as ‘road’, ‘address’ or ‘parcel’.
- Select the layer or layers you want and click OK. Although it is possible to select multiple layers, in practice ArcGIS is often more responsive if only one layer is selected per connection.
- If you’re only wanting to test that the connection is working you can limit the size of the WFS response by entering a Max Features number:
- If you want all records, make sure Max Features is blank. For large layers, specifying a Start Index and Count is recommended. The Start Index should always be 0 and the count within the range of 1000 to 10,000. This causes ArcGIS to get records in a series of smaller requests (or pages) as defined by the count, reducing the chance of getting timeout errors. Note: This feature is only available when using WFS version 2.0.0.
- Click OK on the two open windows. The WFS will be added under the Interoperability Connections. If you wish, the connection can be renamed to something other than the ArcGIS default: