How to set up the Lens Integration
Landscape has two Lens integrations, and both use the same setup, described below.
| Integration | Availability |
|---|---|
| Lens Notes integration | Included with all standard Landscape subscriptions. Turned on by request. |
| Lens Imagery integration | Available only as a paid add-on. |
Lens by Upstream Tech is a subscription service that combines a robust library of purchased geospatial imagery with advanced monitoring tools, allowing users to create in-depth analyses and comparisons over time.
Jump to…
Initial setup
These steps apply both to new Lens users and to existing Lens users who are using the Lens-Landscape integration for the first time.
Prerequisites:
- You must have at least a 'Lens - Standard' subscription to integrate Lens with Landscape.
- You will need an Administrator to access Settings.
Instructions:
- In Data Viewer, start with a View of All Properties. At the very least, the results must contain the Name and Id fields.
- Choose the option to Display as Map.
- Click the Export button on the map that appears. This creates a boundary shapefile of your portfolio.
TIP: This short video explains how to quickly generate a shapefile of multiple records at once using Data Viewer.
- Send the shapefile to Lens:
| If you are… | Do this |
|---|---|
| A new Lens user | Share the shapefile with the Lens team when you set up your account, and tell them you'd like it integrated with Landscape. |
| An existing Lens user | In Lens, select all properties and click Update properties, then upload the .zip file of the exported Landscape portfolio shapefile. Lens matches the properties by geography. You can review the changes in a table and on the map before finalizing, and any notes and imagery within the new property boundaries will persist in Lens. |
- Ask the Lens team for an API key. You will need it in the next step.
- Administrator only: In Landscape, go to Settings > Integrations and find the Upstream Tech block. Click Enable, then enter the API key the Lens team gave you in step #5.
- Administrator only: Click the Integrations Settings button and confirm that src_Id is the field used for synchronization. If the field is blank, type src_Id into the text box.
- Administrator only: Make sure Automatically create new Issues from Lens notes is unchecked. This option is for legacy users of the integration and should not apply to new integrations.
What is the src_Id?
The src_Id is a 24-digit alphanumeric string that is unique to each record in Landscape. When you import a zipped shapefile or .kml file with the src_Id field in its attributes into Lens, Lens sees that field and knows which Landscape record to place the data into. Most record synchronization issues come from this field being missing from the Lens shapefile, or being incorrect. The solution is to re-export the boundary from Landscape and re-import it into Lens.
Add a new record to Lens
To add a new synchronized record in Lens after you've created it in Landscape, export its boundary from Landscape and import it into Lens.
If the property has already been created in Lens, replace its old shapefile with the new one from Landscape by following these instructions.
Instructions:
- In Landscape, navigate to the record and click its boundary on the map.
- Click the Export button and select either the shapefile or .kml option.
You can also use the Export button on the map toolbar, but the exported file must include the boundary file, not the 'Property Area,' 'General Area,' or 'Property Line.'
- Import the exported file into Lens when you create the new property there. The .zip or .kml export of the Landscape boundary already contains the
src_Idfield and doesn't need any editing.
Once the boundary is uploaded, the integration should begin working as soon as the next sync.
Integration Settings
Integration settings are in Settings > Integrations > Upstream Tech. Here are the available actions:
| Setting | What to do |
|---|---|
| Force a sync | Syncs the integration on demand instead of waiting for the next scheduled sync. |
| Landscape record id field name | Keep the default, src_Id. This field is automatically included in every exported record boundary shapefile and is designed to work with this integration. |
| Automatically create new issues from Lens notes | Leave unchecked. This option is only for legacy users of the integration. |
