OceanirDocs

Dashboard
OverviewAPI ReferenceGuidesEnterpriseChangelog
Overview
Quickstart
Authentication
ProductsPro

Orca Geolocation

Orca is Oceanir's flagship geolocation model. Submit any image and receive a precise geographic estimate with confidence scores, visual reasoning, and map-backed evidence.

Endpoint

POSThttps://oceanir.ai/api/v1/geolocate

Request Parameters

KeyTypeReq.Description
image_urlstringYes*Publicly accessible image URL
image_b64stringYes*Base64-encoded image data
depthintNoAnalysis depth: 1 (fast) to 3 (deep)

* Provide exactly one of image_url or image_b64.

Implementation

Node.js
const response = await fetch("https://oceanir.ai/api/v1/geolocate", {
  method: "POST",
  headers: {
    "x-api-key": process.env.OCEANIR_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    image_url: "https://example.com/target.jpg",
    depth: 2
  })
});

const data = await response.json();
console.log(data.location.city, data.confidence);
Python
import requests

payload = {
    "image_url": "https://example.com/target.jpg",
    "depth": 2
}

r = requests.post(
    "https://oceanir.ai/api/v1/geolocate",
    headers={"x-api-key": "YOUR_API_KEY"},
    json=payload
)

print(r.json()["location"])

Benchmarking

1km Accuracy

20.1%

Im2GPS3k

25km Accuracy

46.8%

Im2GPS3k

Avg Latency

4.2s

Standard Load