# Quickstart

For projects listed on DePINScan.io that feature physical devices or nodes, updating the geolocation of these devices on the DePINScan world map enhances visibility and functionality. This guide walks you through using the DePINScan Location API to achieve this.

## Acquiring an API key

#### 1. Login In to depinscan.io

Navigate to <https://depinscan.io> and log in using one of the supported ones (Metamask, GitHub, Google).

#### 2. Create an API Key

Within your dashboard, navigate to the "API" section and click on the "Create API key" button to generate a new API Key.

<figure><img src="https://4046782323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0m2ip6ggBs3GSiSljRjr%2Fuploads%2F62eTWNc0aDiWsDhqePlK%2Fimage.png?alt=media&#x26;token=b053893e-68fa-4449-ac0a-131c880ac9a4" alt=""><figcaption></figcaption></figure>

#### 3. Locate your project UID

Your project UID is located under the "Team projects" section in the DePINScan dashboard.

<figure><img src="https://4046782323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0m2ip6ggBs3GSiSljRjr%2Fuploads%2FGOqLdC7HLNJ5FyZTecgb%2Fimage.png?alt=media&#x26;token=c788705e-8a8c-4ea7-9ab7-85542fd66f6d" alt=""><figcaption></figcaption></figure>

#### 4. API Testing

Utilize the official debugging tools available to test the API, which aids in quickly identifying and resolving API issues.

<figure><img src="https://4046782323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0m2ip6ggBs3GSiSljRjr%2Fuploads%2Fn0YEeOpgVcIW2hGupGkP%2Fimage.png?alt=media&#x26;token=92d368ef-d379-451e-9b6e-db270f289916" alt=""><figcaption><p>Access API Debug tools</p></figcaption></figure>

<figure><img src="https://4046782323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0m2ip6ggBs3GSiSljRjr%2Fuploads%2FNugEnjyWlsRnPx49Xb9m%2Fimage.png?alt=media&#x26;token=1d30d379-482e-408a-bd45-d535bdd24538" alt=""><figcaption><p>API Debug tool</p></figcaption></figure>

#### 4. Obtain API call parameters

After testing, click the "Copy curl code" button to copy the full parameters of your call.&#x20;

Example `curl` command:

```sh
curl -X POST "https://api.depinscan.io/api/upload-device-metrics" -H "Content-Type: application/json" -H "Authorization: mc.6c...17785ca" -d '{
  "uid": "47...5d",
  "events": [
    {
      "custom": {
        "longitude": 90.2,
        "latitude": 22
      },
      "publisher": "device-id"
    }
  ]
}'
```

#### 5. Previewing your data

After uploading data, visit your project's preview page to view all uploaded data points. Note that it may take up to 2 minutes for the data to appear on the page.

<figure><img src="https://4046782323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0m2ip6ggBs3GSiSljRjr%2Fuploads%2FACFcqJoR8vrUAPg3Rckw%2Fimage.png?alt=media&#x26;token=1379b3b5-74db-4fb3-afe2-fdcf97241142" alt=""><figcaption><p>Access your project's preview page</p></figcaption></figure>

<figure><img src="https://4046782323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0m2ip6ggBs3GSiSljRjr%2Fuploads%2F41WWc8uRdHcndYvm0Pmv%2Fimage.png?alt=media&#x26;token=f7c3eeab-318a-4ddd-9bff-d089a8ee1c15" alt=""><figcaption><p>Project Prview</p></figcaption></figure>

{% hint style="info" %}
Please note that it takes about 2 minutes for the data to be uploaded before it can be displayed on the page
{% endhint %}