Skip to navigation
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

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

Set your environment token

Use the Lattice Auth Token from your environment details page as your environment token, then export it so the following commands can authenticate with Lattice:

Bash
export ENVIRONMENT_TOKEN=<YOUR_LATTICE_AUTH_TOKEN>
2

Define the entity

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

entity.json
{
    "entityId": "QUICKSTART_ENTITY_ID",
    "description": "Quickstart example",
    "isLive": true,
    "expiryTime": "<YYYY-MM-DDThh:mm:ssTZD>",
    "aliases": {
        "name": "Simulated Surface Vessel"
    },
    "milView": {
        "disposition": "DISPOSITION_FRIENDLY",
        "environment": "ENVIRONMENT_SURFACE"
    },
    "location": {
        "position": {
            "latitudeDegrees": 33.69447852698943,
            "longitudeDegrees": -117.9173785693163,
            "altitudeHaeMeters": 0
        }
    },
    "ontology": {
        "template": "TEMPLATE_TRACK",
        "platformType": "Surface_Vessel",
        "specificType": "N/A"
    },
    "provenance": {
        "integrationName": "command_line_integration",
        "dataType": "example_data_type",
        "sourceUpdateTime": "<YYYY-MM-DDThh:mm:ssTZD>"
    }
}
3

Publish the entity to Lattice

From the same folder where you saved entity.json, use 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"
4

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 surface vessel was successfully published to Lattice, do the following:

1Open the Lattice UI.
2

Find the vessel in the Entity Explorer. Search by the vessel’s aliases.name to narrow the list:

Shows the Entity Explorer in the Lattice Developer Console.
3

Open the vessel to view its detail page, and confirm its location, name, and other components match the entity you published:

Shows the Simulated Surface Vessel's detail page in the Lattice Developer Console.

What’s next?