Getting started

Quickstart

Publishing a surface vessel to Lattice

Try the Lattice SDK by connecting Lattice environment and publishing a surface vessel entity.

Before you begin

  • Complete the set up steps to log in to the Sandbox and create an environment. If you do not have access to a Lattice Sandbox, request to join the Lattice SDK developer program the Lattice SDK developer program.
  • Confirm you have the curl command-line tool, or install it from the curl website:
    Bash
    $curl --version

Publish a track

To get started with Lattice, consider this scenario: a friendly drone with access to Lattice has picked up a new track that appears to be a surface vessel. To configure this drone to publish a track to Lattice as a new entity, do the following:

1

Define the entity

Copy the following entity JSON object and save it in a new file named entity.json. Replace the timstamp for expiryTime with a time in the future, and sourceUpdateTime with the current time:

entity.json
1{
2    "entityId": "QUICKSTART_ENTITY_ID",
3    "description": "Quickstart example",
4    "isLive": true,
5    "expiryTime": "<YYYY-MM-DDThh:mm:ssTZD>",
6    "aliases": {
7        "name": "Simulated Surface Vessel"
8    },
9    "milView": {
10        "disposition": "DISPOSITION_FRIENDLY",
11        "environment": "ENVIRONMENT_SURFACE"
12    },
13    "location": {
14        "position": {
15            "latitudeDegrees": 33.69447852698943,
16            "longitudeDegrees": -117.9173785693163,
17            "altitudeHaeMeters": 0
18        }
19    },
20    "ontology": {
21        "template": "TEMPLATE_TRACK",
22        "platformType": "Surface_Vessel",
23        "specificType": "N/A"
24    },
25    "provenance": {
26        "integrationName": "command_line_integration",
27        "dataType": "example_data_type",
28        "sourceUpdateTime": "<YYYY-MM-DDThh:mm:ssTZD>"
29    }
30}
2

Publish the entity to Lattice

From the same folder where you saved entity.json, user curl to publish the entity to Lattice:

curl
$curl --location \
>--request PUT "https://$LATTICE_ENDPOINT/api/v1/entities" \
>--header "content-type: application/json" \
>--header "authorization: Bearer $ENVIRONMENT_TOKEN" \
>--header "anduril-sandbox-authorization: Bearer $SANDBOXES_TOKEN" \
>--include \
>--data "@entity.json"
3

Verify the response

If the request is successful, you get a 200 status response with an empty body: {}.

Find the vessel in Lattice

To verify that your published surface vessel was successfully published to Lattice, do the following:

1Open the Lattice UI.
2

Open the track panel from the left hand sidebar. Enter the aliases.name of the surface vessel in the search bar:

Shows the panel where you can search for the surface vessel.
3

To center your view on the surface vessel, select the vessel in the tracks panel, then choose the center icon from the toolbar:

What’s next?