{"source":"marine","operation":"find_aquaculture_sites","description":"Search the official Norwegian aquaculture register (Fiskeridirektoratet)\nfor fish-farming sites, by name, area codes and/or a coordinate radius.","parameters":[{"name":"name","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Partial site name, e.g. \"tuholmane\" (case-insensitive)."},{"name":"municipality_code","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"4-digit kommune number, e.g. \"1244\" (Austevoll). Must be a current code; kommune numbers changed in the 2020 and 2024 reforms (e.g. Gloppen is now \"4650\", not \"1445\")."},{"name":"county_code","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"2-digit fylke number, e.g. \"11\" (Rogaland)."},{"name":"production_area_code","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Production area 1-13, e.g. \"3\" (Karmoy-Sotra)."},{"name":"lat","schema":{"anyOf":[{"type":"number"},{"type":"null"}]},"required":false,"default":null,"description":"WGS84 coordinate for a radius search, e.g. from geonorge address search. Both must be given together."},{"name":"lon","schema":{"anyOf":[{"type":"number"},{"type":"null"}]},"required":false,"default":null,"description":"WGS84 coordinate for a radius search, e.g. from geonorge address search. Both must be given together."},{"name":"radius_km","schema":{"type":"number"},"required":false,"default":25,"description":"Search radius around lat/lon in km (default 25)."},{"name":"limit","schema":{"type":"integer"},"required":false,"default":25,"description":"Max sites to return (default 25, max 100)."},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page."}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/marine/find_aquaculture_sites?name={name}&municipality_code={municipality_code}&county_code={county_code}&production_area_code={production_area_code}&lat={lat}&lon={lon}&radius_km=25&limit=25&offset=0","schema_scope":"#/data in the successful operation envelope","response_schema":{"anyOf":[{"type":"object","properties":{"sites":{"type":"array","items":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."}},"note":{"type":"string"}},"additionalProperties":false},{"anyOf":[{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},{"type":"object","properties":{"site_nr":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"name":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"water":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"placement":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"capacity":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"capacity_unit":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"municipality":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"county":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"production_area":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"production_area_status":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"species_type":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"active_licenses":{"type":"array","items":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."}},"distance_km":{"type":"number"}},"additionalProperties":false}]},{"type":"array","items":{"type":"object","properties":{"site_nr":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"name":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"water":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"placement":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"capacity":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"capacity_unit":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"municipality":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"county":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"production_area":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"production_area_status":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"species_type":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"active_licenses":{"type":"array","items":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."}}},"additionalProperties":false}}]},"response_schema_status":{"status":"incomplete","codegen_safe":false,"description":"Not suitable for typed model generation: the container shape and field names are useful, but unresolved values accept any JSON value."},"entity_projection":{"status":"projected","entity_types":["aquaculture_site","place"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"error_contract":{"scope":"top-level HTTP error response; never part of a success payload","schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}},"additionalProperties":false,"required":["code","message","retryable"]},"suggestion":{"type":"string"},"_meta":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time"},"language":{"type":"string","const":"en"},"content_languages":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object"}}},"required":["retrieved_at","language","content_languages","sources"]},"_links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"api_index":{"type":"string","format":"uri"}},"required":["self","api_index"],"additionalProperties":false}},"additionalProperties":false,"required":["error","suggestion","_meta","_links"]},"statuses":{"400":{"codes":["MISSING_PARAMETER","INVALID_PARAMETER","INVALID_REQUEST"],"retryable":false},"404":{"codes":["SOURCE_NOT_FOUND","OPERATION_NOT_FOUND","ENTITY_NOT_FOUND"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"502":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":true}}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/marine/find_aquaculture_sites/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/marine/find_aquaculture_sites","source":"https://allemannsdata.com/wiki/api/v1/kilder/marine"},"output_fields":["sites","note","site_nr","name","latitude","longitude","water","placement","capacity","capacity_unit","municipality","county","production_area","production_area_status","species_type","active_licenses","distance_km","[].site_nr","[].name","[].latitude","[].longitude","[].water","[].placement","[].capacity","[].capacity_unit","[].municipality","[].county","[].production_area","[].production_area_status","[].species_type"],"output_fields_truncated":true,"canonical_field_aliases":{"name":["name","[].name"],"latitude":["latitude","[].latitude"],"longitude":["longitude","[].longitude"]}}