Point Lookup

1 token per request

Query multiple data layers at a single geographic coordinate. Returns feature information, metadata, and optional geometry for each matched layer at the given point.

POSThttps://api.landmapmagic.com/v1/data/point

Request Body

Parameters

Name	Type	Description
lat*	number	Latitude of the point to query. Range: -90 to 90.
lng*	number	Longitude of the point to query. Range: -180 to 180.
layers*	string[]	Array of layer names to query at the given point. See Available Layers below.
options	object	Optional configuration object for the query. See Options below.

Options

Name	Type	Description
includeGeometry	boolean	Include full GeoJSON geometry for each matched feature. Default: false. Increases response size significantly.
includeMetadata	boolean	Include layer metadata such as source, update date, and zoom information. Default: true.

Available Layers

Supported Layers

Attribute	Type	Description
states	polygon	U.S. state boundaries with FIPS codes and names. Optimal at zoom 4.
counties	polygon	U.S. county boundaries with FIPS codes, names, and state references. Optimal at zoom 6.
townships	polygon	PLSS township boundaries. Includes township, range, and principal meridian. Optimal at zoom 10.
sections	polygon	PLSS section boundaries (640-acre subdivisions within townships). Optimal at zoom 14.
clu	polygon	Common Land Unit (CLU) field boundaries from the USDA FSA. Optimal at zoom 14.
cdl:YYYY	raster	USDA Cropland Data Layer for a specific year (e.g. cdl:2023). Returns the crop code at the queried point. Optimal at zoom 12.

Pricing is 1 token per request regardless of how many layers you query. Query multiple layers in a single request to minimize costs.

Response Fields

Result Object (per layer)

Attribute	Type	Description
layer	string	The layer name that was queried.
found	boolean	Whether a feature was found at the queried point for this layer.
feature.id	string	Unique identifier for the matched feature (e.g. FIPS code, CLU ID).
feature.name	string	Human-readable name for the matched feature.
feature.properties	object	Layer-specific properties of the matched feature. Varies by layer type.
zoom.optimal	number	Recommended zoom level for viewing this layer's data.
metadata	object	Layer metadata including source, last updated timestamp, and attribution. Only present when includeMetadata is true.

Code Examples

Basic Point Lookup

cURL

curl -X POST "https://api.landmapmagic.com/v1/data/point" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lat": 42.0308,
    "lng": -93.4816,
    "layers": ["states", "counties", "townships"]
  }'

JavaScript

const response = await fetch(
  "https://api.landmapmagic.com/v1/data/point",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      lat: 42.0308,
      lng: -93.4816,
      layers: ["states", "counties", "townships"],
    }),
  }
);
const data = await response.json();
data.results.forEach((r) => {
  console.log(`${r.layer}: ${r.found ? r.feature.name : "not found"}`);
});

Python

import requests

response = requests.post(
    "https://api.landmapmagic.com/v1/data/point",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "lat": 42.0308,
        "lng": -93.4816,
        "layers": ["states", "counties", "townships"],
    },
)
data = response.json()
for r in data["results"]:
    name = r["feature"]["name"] if r["found"] else "not found"
    print(f"{r['layer']}: {name}")

With Geometry and CDL

cURL

curl -X POST "https://api.landmapmagic.com/v1/data/point" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lat": 41.8781,
    "lng": -93.0977,
    "layers": ["counties", "clu", "cdl:2023"],
    "options": {
      "includeGeometry": true,
      "includeMetadata": true
    }
  }'

JavaScript

const response = await fetch(
  "https://api.landmapmagic.com/v1/data/point",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      lat: 41.8781,
      lng: -93.0977,
      layers: ["counties", "clu", "cdl:2023"],
      options: {
        includeGeometry: true,
        includeMetadata: true,
      },
    }),
  }
);
const data = await response.json();
console.log(data.results);

Python

import requests

response = requests.post(
    "https://api.landmapmagic.com/v1/data/point",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "lat": 41.8781,
        "lng": -93.0977,
        "layers": ["counties", "clu", "cdl:2023"],
        "options": {
            "includeGeometry": True,
            "includeMetadata": True,
        },
    },
)
data = response.json()
print(data["results"])

Response Example

States + Counties + Townships Query

{
  "results": [
    {
      "layer": "states",
      "found": true,
      "feature": {
        "id": "19",
        "name": "Iowa",
        "properties": {
          "fips": "19",
          "abbreviation": "IA",
          "area_sq_mi": 56272.81
        }
      },
      "zoom": {
        "optimal": 4
      },
      "metadata": {
        "source": "U.S. Census Bureau TIGER/Line",
        "updated": "2024-01-15",
        "attribution": "U.S. Census Bureau"
      }
    },
    {
      "layer": "counties",
      "found": true,
      "feature": {
        "id": "19169",
        "name": "Story County",
        "properties": {
          "fips": "19169",
          "state_fips": "19",
          "state_name": "Iowa",
          "area_sq_mi": 573.21,
          "population": 98537
        }
      },
      "zoom": {
        "optimal": 6
      },
      "metadata": {
        "source": "U.S. Census Bureau TIGER/Line",
        "updated": "2024-01-15",
        "attribution": "U.S. Census Bureau"
      }
    },
    {
      "layer": "townships",
      "found": true,
      "feature": {
        "id": "IA050830N0220W0",
        "name": "T83N R22W",
        "properties": {
          "township": "83N",
          "range": "22W",
          "principal_meridian": "5th Principal Meridian",
          "state": "IA",
          "area_acres": 23040
        }
      },
      "zoom": {
        "optimal": 10
      },
      "metadata": {
        "source": "BLM PLSS CadNSDI",
        "updated": "2023-11-01",
        "attribution": "Bureau of Land Management"
      }
    }
  ]
}

Loading documentation...