Skip to main content

Connect to an API Endpoint

Add a custom ESRi or WMS layer from a server

Holly Conrad Smith avatar
Written by Holly Conrad Smith
Updated over 3 months ago

Import ESRi or WMS layers via API url for data that stays up to date at all times.

Many governments and companies host their data on open data servers. Take advantage of this free data by linking that layer into your Giraffe project.

Access the Layer Upload Applet

Navigate to the Layer Palette, then click “New data layer”

When the Layer Library opens, click “Create new Layer” on the right hand side

The dropdown displays all of the layer type options. Select Esri or WMS

The layer applet will appear in the right hand palette.

Find an API Service

The tricky part is finding the right API url. Web search is your best friend. Try searching query + gis in Google. (IE “NSW parcels GIS”).

Esri

Esri, which stands for Environmental Systems Research Institute, is a leading American multinational company that develops and sells Geographic Information System (GIS) software and technology.

  • URLs must have mapserver, featureserver, imageserver, or sceneserver at the end of the link.

  • Private URLs must include the token embedded as a query parameter - ?token=<TOKEN>

  • The api endpoint webpage typically looks like this:

WMS

WMS stands for Web Map Service, an Open Geospatial Consortium (OGC) standard for serving and consuming dynamic, georeferenced map images over the internet.

  • URLs must contain GetCapabilities.

  • The webpage typically looks like this:

Connect to the Service

  1. Connect to the Server

    1. Paste the URL of the service into the URL box

    2. then click “Fetch Layers”

  2. Select Layer

    1. A visual preview of any of the layers contained within that URL are displayed.

    2. Select one to import.

    3. then click next

  3. Layer details

    1. Name the layer

    2. add a description. By default, Giraffe attempts to import descriptions contained within the layer's metadata.

  4. Click “save layer” to add the layer to your project.

Did this answer your question?