If the Layer Library doesn ‘t have what you’re looking for, existing maps and designs can be added to a Giraffe project for reference, as context or to trace over. The supported file formats are:

• Vector sources:
  • GeoJSON files (.geojson)
  • Shape files ( .shp / .dbf / .prj )
  • Cad files ( .dxf )
  • Spreadsheets with addresses (.csv)
• ESRi Mapserver or Featureserver or Sceneserver
• WMS
• Mapbox
• Raster sources:
  • Images (.png / .jpeg)
  • PDF files (.pdf)

Layer Governance

When you upload your own layers, they are stored within your Workspace.

Users inherit view access to Layers in Projects they have access to. Meaning, if someone has access to a project, they can see all of the layers within that project’s Layer Palette.

To prevent users from seeing a layer in projects, mark the layer as sensitive in Manage Layers. Sensitive layers must be explicitely shared to a particular user for them to see it in Layer Library or their. Projects

<aside>

Learn more in Manage Layers

</aside>

Users do not automatically have access to search and find layers they have access to in a project in the Layer Library.

To share layers you’ve added with other Members, Teams, or your entire Workspace, share the Layer.

<aside>

Learn more in How to Share Data

</aside>

Access the Import Layer Applet

There are 2 ways to open the layer upload applet:

Data layer → Create Your own → select layer type

Main menu (☰) → Layers → select layer type

<aside> 💡 You can also drag any file into your giraffe window to automatically open the correct applet for that filetype.

</aside>

Importing Vector Data

Filetypes that are considered vectors for the purpose of uploading:

• .json → GeoJSON format

  <aside> 🎓 GeoJSON is a widely-used data format for displaying vectors in web maps . It is based on JavaScript object notation, a simple and minimalist format for expressing data structures using syntax from JavaScript.

  </aside>

• .shp → Shape File format

  • Shapefiles are contained within .zip directories with multiple files that control the metadata, geolocation, and functionality of the data
  • Shapefiles can be point or polygon based

• .kml or .kmz → Google Earth format

• .dxf → CAD open data format

• .csv → Comma Separated spreadsheet.

  • For Point data only.
  • Requires a ADDRESS column with full address in that column
  • Row limit is 100 records

The data can be added as a data layer or converted into Giraffe features:

• Map data layers can be shared between users and added to multiple projects.
• Giraffe features will be added to the current project.

1. Upload a file

   1. Browse your computer
   2. Select a file
   3. click “Next”

2. Style layer

   1. Select “To create a layer” to add a layer
   2. Filter and Style your Layer using Lens (Data Table) controls

<aside> 💡

Click Import to Project if you want to add the shapes as polygons in your project rather than creating a layer

</aside>

<aside> 👉 Learn how to filter and style with Lens (Data Table)

</aside>

1. Layer details
   1. Name the layer
   2. add details.
2. Click “save layer” to add the layer to your project.

A Note on Filetypes:

<aside> ✅ GeoJSON, shape files, and KMZ files are easy to import into Giraffe. These are geospatial first data types and are easily parsed by the layer import applet.

</aside>

<aside> 👉 Shapefiles are contained within .zip directories with multiple files that control the metadata, geolocation, and functionality of the data. DO NOT UNZIP THE FILE. You must upload the entire zipped directory.

</aside>

<aside> ⚙️ Excel, Google Sheets, or other spreadsheet sources must be converted to CSV (comma delimited) before importing as a layer.

</aside>

<aside> 📢 CSV files can only reflect point based data. They need to include a column labeled ADDRESS with the street address. The row limit is 100 per upload.

</aside>

<aside> 🚨 Importing CAD (.dxf) vector data is often complex. DXF files are not typically geolocated, and depending on how they are authored, they may consist of many line segments rather than the line-strings and polygons which are native to Giraffe.

On the other hand, even line segments can be very useful to allow tracing using Giraffe's snap feature (holding down "s" will snap to any vector features on the map).

If there is a large amount of useful data that is only accessible as DXF files, you can follow the steps in How to import DXF files into Giraffe. Reach out to us using the in-app chat for support doing this.

</aside>