Picarta AI API

https://picarta.ai/api
Admin
Picarta AI API provides image geolocalization services, estimating GPS coordinates from images using...
Tokens:2,162
Snippets:6
Trust Score:8.5
Update:1 year ago
Show doc for...
Tokens:
Raw
### Geolocate Image with Picarta API (Javascript)

Source: https://picarta.ai/api/index

Demonstrates how to geolocate an image using the Picarta API with Javascript. This example shows how to read image data from a local file, convert it to base64, and send it as a JSON payload in a POST request using the `fetch` API. It includes handling for API tokens, optional search parameters, and response processing.

```Javascript
const fs = require('fs');

const url = "https://picarta.ai/classify";
const apiToken = "API_TOKEN"; // Replace with your API token
const headers = {"Content-Type": "application/json"};

// Read the image from a local file
const imagePath = "path/to/local/image";
const imageData = fs.readFileSync(imagePath);
const imgPath = Buffer.from(imageData).toString('base64');

// OR from a URL
// const imgPath = "https://upload.wikimedia.org/wikipedia/commons/8/83/San_Gimignano_03.jpg";

// Optional parameters for a specific location search.
// If you want to search worldwide, keep these as null.
// center_latitude and center_longitude define the center of the search area.
// radius defines the search area around the center point in kilometers.
let center_latitude = null;
let center_longitude = null;
let radius = null;
let top_k = 3; // You can choose up to 10 GPS predictions. The default is 3


// Prepare the payload
const payload = {
    "TOKEN": apiToken,
    "IMAGE": imgPath,
    "TOP_K": top_k,
    "Center_LATITUDE": center_latitude,
    "Center_LONGITUDE": center_longitude,
    "RADIUS": radius,
};

// Send the POST request with the payload as JSON data
fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(payload)
})
.then(response => {
    if (response.ok) {
        return response.json();
    } else {
        throw new Error("Request failed with status code: " + response.status);
    }
})
.then(result => {
    console.log(result);
})
.catch(error => {
    console.error("Request failed with error:", error);
    console.error(response.text);
});
```

--------------------------------

### Geolocate Image via Picarta API (Direct HTTP Request)

Source: https://picarta.ai/api/index

Provides examples of how to geolocate an image by making direct HTTP POST requests to the Picarta API. This method is useful when not using the official Python package. It covers reading image data from a local file using base64 encoding or directly using a URL. The payload includes the API token, image data, and optional search parameters.

```Python
import requests
import json
import base64

url = "https://picarta.ai/classify"
api_token = "API_TOKEN"  # register to get the token
top_k = 3 # You can choose up to 100 GPS predictions. The default is 10
headers = {"Content-Type": "application/json"}

# Read the image from a local file, comment out the next two lines if you read from URL 
with open("path/to/local/image.jpg", "rb") as image_file:
    img_path = base64.b64encode(image_file.read()).decode('utf-8')

# OR  

# from a URL, comment out the next line if you read from a local file
#img_path = "https://upload.wikimedia.org/wikipedia/commons/8/83/San_Gimignano_03.jpg"

# Optional parameters for a specific location search. 
# If you want to search worldwide, keep these as None;
# center_latitude and center_longitude define the center of the search area.    
# radius defines the search area around the center point in kilometers.
center_latitude, center_longitude, radius = None, None, None 

# Prepare the payload 
payload = {"TOKEN": api_token,
           "IMAGE": img_path,
           "TOP_K": top_k,
           "Center_LATITUDE": center_latitude,
           "Center_LONGITUDE": center_longitude,
           "RADIUS": radius}

# Send the POST request with the payload as JSON data
response = requests.post(url, headers=headers, json=payload, timeout=120)

if response.status_code == 200:
    result = response.json()
    print(result)
else:
    print("Request failed with status code:", response.status_code)
    print(response.text)
```

--------------------------------

### Geolocate Image with Picarta Python Package

Source: https://picarta.ai/api/index

Demonstrates how to use the Picarta Python package to geolocate an image. It shows how to initialize the Picarta client with an API token and then use the localize method with either a local image path or a URL. Optional parameters for search radius and center coordinates can be provided for targeted searches.

```Python
from picarta import Picarta

api_token = "YOUR_API_TOKEN"
localizer = Picarta(api_token)

# Geolocate a local image worldwide
result = localizer.localize(img_path="/path/to/local/image.jpg")

print(result)

# Geolocate an image from URL with optional parameters for a specific location search
# If you want to search worldwide, keep these as None;
# center_latitude and center_longitude define the center of the search area.    
# radius defines the search area around the center point in kilometers.

result = localizer.localize(
img_path="https://upload.wikimedia.org/wikipedia/commons/8/83/San_Gimignano_03.jpg",
top_k=10,
center_latitude=43.464, 
center_longitude=11.038,
radius=100)

print(result)
```

--------------------------------

### Geolocate Image using Wget

Source: https://picarta.ai/api/index

This snippet shows how to geolocalize an image using the wget command to interact with the Picarta AI API. It supports both local image files and images from URLs, with options to define search parameters like center coordinates and radius.

```bash
base64_image=$(base64 -w0 "/path/to/local/image.jpg")

# For image from a URL (comment out the above line and uncomment the next line)
#base64_image=$(base64 -w0 <(wget -qO- "https://upload.wikimedia.org/wikipedia/commons/8/83/San_Gimignano_03.jpg"))

center_latitude=null
center_longitude=null
radius=null
top_k=3

echo '{
    "TOKEN": "API_TOKEN", 
    "IMAGE": "'"$base64_image"'",
    "TOP_K": "'"$top_k"'",
    "Center_LATITUDE": "'"$center_latitude"'", 
    "Center_LONGITUDE": "'"$center_longitude"'", 
    "RADIUS": "'"$radius"'"
}' > payload.json

wget --method=POST \
     --header='Content-Type: application/json' \
     --body-file=payload.json \
     --output-document=picarta_output.json \
     https://picarta.ai/classify
```

--------------------------------

### Picarta AI API Services

Source: https://picarta.ai/api/index

This section details the core functionalities offered by the Picarta AI API. It covers AI-driven GPS estimation for images without EXIF data, extraction of comprehensive EXIF metadata, and the georeferencing of aerial imagery from various sources.

```APIDOC
Image to GPS:
  Description: Provides GPS estimation for images lacking GPS EXIF data using AI.
  Input: Image file (without GPS EXIF data).
  Output: Estimated GPS coordinates (latitude, longitude).
  Dependencies: AI model for location estimation.

Image EXIF Data:
  Description: Retrieves detailed EXIF data from images.
  Input: Image file.
  Output: EXIF metadata including camera model, timestamps, and other relevant information.
  Dependencies: Image parsing library.

Aerial imagery:
  Description: Accurately georeferences aerial imagery captured by aircraft, drones, and satellites.
  Input: Aerial image file.
  Output: Georeferenced image with location data.
  Dependencies: Georeferencing algorithms, satellite/drone/aircraft imagery data.

Landmarks detection:
  Description: Detects landmarks within images. This service will be provided soon.
  Status: Upcoming feature.
```

--------------------------------

### Geolocate Image using Curl

Source: https://picarta.ai/api/index

This snippet demonstrates how to geolocalize an image by sending a POST request to the Picarta AI API using curl. It includes options for using a local image file or an image from a URL, and allows for specifying search radius and accuracy parameters.

```bash
img_path=$(base64 -w0 "/path/to/local/image.jpg")

# OR

#img_path="https://upload.wikimedia.org/wikipedia/commons/8/83/San_Gimignano_03.jpg"

center_latitude=null
center_longitude=null
radius=null
top_k=3

echo '{
    "TOKEN": "API_TOKEN", 
    "IMAGE": "'"$img_path"'", 
    "TOP_K": "'"$top_k"'", 
    "Center_LATITUDE": "'"$center_latitude"'", 
    "Center_LONGITUDE": "'"$center_longitude"'", 
    "RADIUS": "'"$radius"'"
}' > payload.json

curl --request GET \
    --url https://picarta.ai/classify \
    --header 'Content-Type: application/json' \
    --data @payload.json
```
Tokens:
Raw