{"uid":"cap_A7zAvOr4AHYKBo8-oneYr","slug":"geoprimitives-marine-depth-lookup-bc151f46","name":"geoprimitives Marine Depth Lookup","description":"Give it a latitude and longitude and it answers with what the nautical chart says about the water there: the depth range of the charted depth area containing the position, the nearest charted sounding and how far away it is, and the chart's own zone of confidence for that area. Parameters go in the query string: this is a GET, there is no body. NOT FOR NAVIGATION, stated first because it is a condition of using the source. This is derived from NOAA Electronic Navigational Charts and redistributed; it is not an official NOAA ENC and does not meet federal chart carriage regulations under 33 CFR 164 or SOLAS chapter V, which only charts from NOAA or a certified NOAA ENC distributor do. Every response repeats this under `disclaimer`. NOAA and NOAA ENC are registered trademarks of NOAA, which does not endorse this service. COVERAGE is 65 NOAA ENC cells of usage bands 3, 4 and 5 over five working areas of southeast and southcentral Alaska: Sitka Sound; Kasaan Bay and Clarence Strait; Metlakatla, Ketchikan and Revillagigedo Channel; Juneau, Gastineau Channel and Lynn Canal; and Cordova with eastern Prince William Sound. It is not statewide, it is not the whole coast, and the small-scale cells that would make it look wider were deliberately left out. The coverage check reads the coordinate, so it runs in the handler after payment rather than in front of the 402: a position off the charts is quoted like any other and then refused with outside_coverage. A refusal does not settle and nothing is charged, but it costs a signature and a round trip, so check the coverage first. Every response repeats it under `coverage`. NOTHING IS INTERPOLATED, and that is the difference between this and GET /v1/elevation. Terrain is a continuous surface and sampling it between pixels is legitimate; a chart is a set of assertions a hydrographer made, and averaging two of them invents a depth nobody surveyed. So `depthAreaMinimum` is DRVAL1 of the charted depth area the position falls inside, the shoalest depth that area is guaranteed to hold, and `nearestSounding` is a real charted sounding with the geodesic distance to it. The two routinely disagree and are meant to: a sounding is a measurement at a point and the area is a guarantee over a region. The guarantee is the number to navigate a plan by; the sounding tells you how the area was arrived at. WHICH CHART ANSWERS: ENC cells overlap on purpose, so a position in Sitka sits on a 1:12,000 harbour cell, a 1:45,000 approach cell and a 1:180,000 coastal cell at once, and they do not agree because the smaller scales generalise. The largest-scale cell covering the position wins outright, usage band first and then compilation scale, which is the rule an ECDIS follows. The response names the cell, its band, its scale, its edition and its NOAA issue date, and lists any cell it consulted first that charted no depth area there. SURVEY QUALITY is on every answer as the chart's CATZOC zone of confidence, with the position and depth accuracy that zone implies, and the survey start and end dates when the chart gives them. Read it before you trust a depth. NOAA's own warning applies to all of it: much of the depth information on NOAA charts is from surveys conducted before 1940 and the shoreline is more than 20 years old. Zone A1 is a modern full-coverage survey; zone D or U means the chart is telling you it does not know. DATUMS: depths are metres below Mean Lower Low Water, which is the US chart datum, so a real depth at a real moment is this number plus the tide. Heights on the same charts are above Mean High Water. Positions are WGS 84. Reproject with POST /v1/transform if you are in State Plane or NAD27; the datum shift matters here, since a NAD27 Alaskan position is over a hundred metres from its WGS 84 one. VINTAGE: the charts are a snapshot taken on 2026-05-02. NOAA reissues ENCs weekly for Notice to Mariners and this store does not follow them, so a cell here can be behind NOAA's current edition. The cell edition, update number and issue date that answered are in `source` for exactly that comparison. REFUSALS that cost nothing: a position with no charted depth area is `no_depth_area`, which means land, a drying area the chart gives no depth for, or a gap between cells, and it is refused rather than answered with null. A position off the charts is `outside_coverage`. A chart object that cannot be read is a 503, not a guess. For what is in the way rather than how deep it is, use GET /v1/marine/hazards, which returns charted rocks, obstructions and wrecks within a radius.","url":"https://api.geoprimitives.dev/v1/marine/depth?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees, EPSG:4326. Refused outside -90..90."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees, EPSG:4326. Refused outside -180..180."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5jFRgZjJpp7Iv-0DtsrMe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns charted water depth range, nearest sounding distance, and NOAA ENC zone of confidence for a given latitude/longitude in southeast and southcentral Alaska.","exampleAgentPrompt":"What does the nautical chart say about the water depth at latitude 57.05, longitude -135.33 in Sitka Sound — give me the charted depth range, how far the nearest sounding is, and the zone of confidence for that area.","exampleUseCases":[{"title":"Marine survey pre-planning in Alaska","prompt":"I'm planning a survey vessel route through Kasaan Bay — can you check the charted depth range and zone of confidence at 55.52 latitude, -132.41 longitude so I know what the NOAA ENC shows for that spot?"},{"title":"Anchoring site depth check","prompt":"We're looking for a safe anchorage near Metlakatla and I need to know the charted water depth range and nearest sounding at latitude 55.13, longitude -131.57 — what does the nautical chart say?"},{"title":"Hazard awareness for a specific position","prompt":"Can you tell me the charted depth area and zone of confidence from the NOAA ENC data for the position at lat 56.98, lon -134.12 in southeast Alaska waters?"}],"resultDescription":"Returns the depth range (min/max) of the charted depth area containing the queried position, the distance to and value of the nearest charted sounding, and the chart's zone of confidence for that area. Every response also includes a mandatory disclaimer that the data is derived from NOAA ENC and is NOT FOR NAVIGATION.","failureModes":["Coordinates outside the 65 NOAA ENC cells of coverage (southeast/southcentral Alaska) — returns an out-of-coverage error","Latitude outside -90..90 or longitude outside -180..180 — request refused with validation error","Position falls on land or outside any charted depth area — may return no depth area match","Payment not provided or invalid — x402 payment required error","Service unavailable or network timeout"],"whenToPreferThis":"Use this endpoint when you need to query water depth metadata — depth range, nearest sounding, and zone of confidence — for a specific point in southeast or southcentral Alaska (e.g. Sitka Sound, Kasaan Bay, Clarence Strait, Metlakatla area) derived from NOAA ENC data. It is the right choice for marine research, route pre-planning, or geospatial enrichment of positions in these waters. Do not use it as an authoritative navigation chart or to satisfy federal chart carriage regulations (33 CFR 164 or SOLAS chapter V).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:33:48.185Z","isFirstParty":false,"canonicalSlug":"geoprimitives-marine-depth-lookup-bc151f46"}