{"schema_version":"1.0","country":"es","country_name":"Spain","topic":"ports","question":"Where can I get a list of commercial ports in Spain, with location, port authority and annual cargo, passengers and vessel calls?","territory":"es","territory_level":"country","parent_url":null,"published_on":"2026-11-19","research_reviewed_on":"2026-11-16","access_checked_on":null,"answer":{"official_data":"partial","non_official_data":"partial","summary":"For the 46 state-owned ports of general interest (28 Port Authorities), Puertos del Estado publishes everything asked, per port: an ArcGIS FeatureServer (port points, AP, cargo t, TEU, vessel calls, passengers, 2010-2024) and the Anuario 2025 XLSX (2025 data, coordinates in degrees-minutes). Regional (non-state) commercial ports have no national list; only Catalonia, Galicia and Canarias (passengers) were found, partially.","main_caveats":["The ArcGIS traffic table stops at 2024; the Anuario 2025 XLSX (embedded in the PDF) has 2025. Monthly summaries exist per Port Authority, not per port.","Puertos del Estado data covers only the 46 state ports; commercial ports run by regions (e.g. Palamos, Garrucha, Ribadeo) are in separate regional sources.","Port coordinates are whole or decimal arc-minutes (about 1-2 km); Anuario sheet 2_1 has Arinaga at 25º24W (wrong, about 737 km offshore).","'Vessels' are merchant ship calls, not unique ships; passengers are movements. Glossary says gross weight excludes tares, tables footnote says tares included.","No open licence: puertos.es aviso legal requires prior written authorisation for reproduction/exploitation; the ArcGIS item states no licence."],"confidence":"medium","confidence_reason":"State-port answer verified by download and cross-checked (2024 total matches in two sources); regional coverage is a sample of 4 of ~10 coastal regions.","attributes":[{"attribute":"location","covered":"partial","source_ids":["s001","s002","s004"],"note":"Point in degrees-minutes (arc-minute precision) per state port; service-zone polygons in rank 4. None for regional ports.","gap":"not_checked","gap_note":"Regional ports: coordinates not found in the regional sites opened; Valencia, Basque Country, Cantabria, Asturias, Murcia not opened."},{"attribute":"port_authority","covered":"yes","source_ids":["s001","s002","s004"],"note":"Autoridad_Portuaria column per port (28 APs) in rank 2 table; regional ports have regional agencies instead.","gap":null,"gap_note":null},{"attribute":"annual_cargo","covered":"partial","source_ids":["s001","s002","s005","s006"],"note":"Tonnes per state port, 2010-2025. Regional: Catalonia (4 ports) yes; Galicia summary only; Eurostat gives a different scope.","gap":"not_checked","gap_note":"Cargo per regional port not opened for Andalucia, Valencia, Basque Country, Cantabria, Asturias, Balearic and Canarias regional ports."},{"attribute":"annual_passengers","covered":"partial","source_ids":["s001","s002","s005"],"note":"Non-cruise and cruise passengers per state port; regional: Catalonia yearbook, ISTAC for Canarias regional ports.","gap":"not_checked","gap_note":"Regional ports of other regions not opened."},{"attribute":"annual_vessel_calls","covered":"partial","source_ids":["s001","s002","s005"],"note":"Merchant ship calls (number and GT) per state port; Catalonia regional ports in its yearbook.","gap":"not_checked","gap_note":"Calls for regional ports of other regions not opened; ISTAC set is passengers only."}]},"sources":[{"source_id":"s001","name":"Anuario Estadistico del Sistema Portuario de Titularidad Estatal 2025 (PDF with 30 embedded XLSX)","publisher":"Organismo Publico Puertos del Estado - Departamento de Estadistica","official":true,"landing_url":"https://www.puertos.es/en/data/statistics/annual","data_url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","access":"pdf","format":"PDF (234 pages) with embedded XLSX attachments (pdfdetach)","license":"unknown (no open licence; aviso legal requires written authorisation for reuse)","language":"es/en","has_coordinates":true,"location_precision":"exact","publisher_type":"national_government","adds":null,"first_seen_pass":1,"rank":1,"summary":"Anuario Estadistico del Sistema Portuario de Titularidad Estatal 2025 (PDF with 30 embedded XLSX)","coverage_note":"46 state-owned ports of general interest managed by 28 Port Authorities (48 rows incl. Zona Franca, Puerto de Santa Maria, La Cabezuela; 2025 data). Regional ports not included.","data_date":"Calendar year 2025 (edition published October 2026)","caveats":["Consult the main caveats and the complete reading traps and access evidence in the detail."],"coverage":{"geographic":"46 state-owned ports of general interest managed by 28 Port Authorities (48 rows incl. Zona Franca, Puerto de Santa Maria, La Cabezuela; 2025 data). Regional ports not included."},"fine_print":{"unit":{"value":"Cargo in tonnes; passengers and ship calls in number; ship size in GT; containers in TEU","quote":"Datos en toneladas / Tonnes (sheet 3_5_1.xlsx); Datos en numero / Number (3_4_1_x.xlsx)","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","attempts":[]},"inclusion_rule":{"value":"Ports of the 28 Spanish Port Authorities of general interest; data supplied by the APs","quote":"En el Anuario Estadistico del Sistema Portuario de Titularidad Estatal se recogen, principalmente, los datos del trafico portuario de mercancias, de contenedores, de buques y de pasajeros de las 28 Autoridades Portuarias espanolas de interes general.","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","attempts":[]},"reference_date":{"value":"Calendar year 2025 (edition published October 2026)","quote":"Madrid, octubre de 2026 / Annual Statistical Report 2025","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","attempts":[]},"update_frequency":{"value":"Annual; edition 2024 published 2025-10, edition 2025 published 2026-10","quote":"Anuario 2025 .../2026-10/..., Anuario 2024 .../2025-10/... (file paths listed on the annual statistics page)","url":"https://www.puertos.es/en/data/statistics/annual","attempts":[]},"exclusions":{"value":"Merchant ships exclude warships, fresh-fishing vessels, supply vessels, tugs, dredgers, oceanographic and training ships; 'ships' are calls and passengers are movements, not unique ships/people","quote":"Los datos relativos a buques realmente reflejan escalas, no buques unicos. ... no tienen tal consideracion los buques de guerra, de pesca fresca, de avituallamiento, remolcadores, dragas...","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","attempts":[]}},"key_fields":[{"field":"3_5_2.xlsx sheet 352: A,B,C,D,E,F,G,H","meaning":"Port Authority (first row of group only), port, TEU, merchant ships number, GT, non-cruise passengers, cruise passengers, total passengers"},{"field":"3_5_1.xlsx sheet 351","meaning":"Per port tonnes: liquid bulk, solid bulk, general cargo, fish, supplies, local traffic, total (col I)"},{"field":"2_1.xlsx sheet 211: B,C","meaning":"Longitude and latitude in degrees-minutes (E/O, N), per port (arc-minute precision)"},{"field":"3_3_1.xlsx sheet 331","meaning":"Merchant ships entered per Port Authority: Spanish/foreign/total number and GT"}],"how_to_use":{"example_request":"curl -sL -o anuario2025.pdf 'https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf' ; mkdir x && cd x && pdfdetach -saveall ../anuario2025.pdf ; then read 3_5_2.xlsx (sheet 352, rows from 6), 3_5_1.xlsx (sheet 351) and 2_1.xlsx (sheet 211, rows from 6)","example_result":"3_5_2.xlsx row 51: Valencia | TEU 5603223 | merchant ships 5991 | GT 275806708 | non-cruise passengers 861746 | cruise 799050 | total 1660796. 3_5_1.xlsx row 51: Valencia total 72844635 t. 2_1.xlsx row 53: Valencia | 0º18,1'O | 39º26,9'N","steps":["Download the PDF (25.9 MB, Content-Type application/pdf) and extract the 30 embedded XLSX with pdfdetach -saveall into an empty directory.","Join sheets by port name: 3_5_1 (tonnes), 3_5_2 (TEU, calls, passengers) and 2_1 (position). Names differ between sheets, normalise accents/case/trailing spaces (Alcudia/Alcúdia, Puerto Rosario vs Puerto del Rosario, 'Puerto de Santa Maria' vs 'El Puerto de Sta. Maria').","Forward-fill column A (Port Authority) in 3_5_1/3_5_2: it is filled only on the first port of each authority (merged cells). Drop the TOTAL row (row 54).","Convert degrees-minutes (accept both 38º20'N and decimal minutes 39º26,9'N) to decimal degrees; O = west (negative)."],"reading_traps":["48 port rows but 46 ports of general interest: includes Zona Franca, Puerto de Santa Maria, La Cabezuela-Puerto Real, Salinetas, Arinaga (ArcGIS layer tags 6 of them as 'Puertos con Valor Estadistico').","Sheet 2_1.xlsx: Arinaga longitude is 25º24'O (typed), which falls about 737 km west of the Canary Islands; the ArcGIS layer has 15º23'O. 1 of 52 coordinates tested fell outside Spain.","Coordinates are whole or decimal minutes only (1 arc-minute about 1.85 km latitude): good for a map of ports, not for distances to quays.","Port Authority totals (3_1_x, 3_3_1, 3_4_1_x) are per authority, not per port: Baleares, Bahia de Cadiz, Las Palmas, Santa Cruz de Tenerife, Valencia, Almeria, Ferrol-San Cibrao each cover several ports.","Glossary defines gross weight as excluding tares, yet table footnotes say 'Incluye cargas, descargas, transitos, transbordos y taras'; both statements are in the same document (unresolved)."]},"test":{"tested_on":"2026-11-16","method":"download","http_status":200,"content_type":"application/pdf","size_bytes":25881705,"records_total":48,"records_for_country":48,"problems":[]},"evidence":[{"claim":"The Excel files are embedded in the PDF","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","quote":"Los ficheros Excel del Anuario 2025 se encuentran en \"Archivos adjuntos\" de este documento PDF"},{"claim":"2025 total and 2024 comparison","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","quote":"En 2025 se movieron un total de 556,2 millones de toneladas de mercancias por todo el Sistema Portuario de Titularidad Estatal"},{"claim":"Ships are calls","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","quote":"Los datos relativos a buques realmente reflejan escalas, no buques unicos."}],"members":[],"members_summary":null},{"source_id":"s002","name":"Visor Corporativo Puertos del Estado - ArcGIS FeatureServers (Puertos points, Trafico_Puertos table, Autoridades_Portuarias)","publisher":"Organismo Publico Puertos del Estado","official":true,"landing_url":"https://experience.arcgis.com/experience/59d21bbe70a746eba2e1fa33a9bab8a5/page/VISOR/","data_url":"https://services9.arcgis.com/Ihvzfbme6HOduMK5/arcgis/rest/services/Trafico_Puertos_(Vista)/FeatureServer/0","access":"api","format":"ArcGIS REST (JSON, also csv/shapefile/geojson/xlsx exports)","license":"unknown (item has no licence text; puertos.es aviso legal requires written authorisation)","language":"es","has_coordinates":true,"location_precision":"exact","publisher_type":"national_government","adds":"Same per-port data as rank 1 as a queryable API with 15 years (2010-2024) and port points in decimal degrees; lags rank 1 by one year.","first_seen_pass":1,"rank":2,"summary":"Visor Corporativo Puertos del Estado - ArcGIS FeatureServers (Puertos points, Trafico_Puertos table, Autoridades_Portuarias)","coverage_note":"State ports of general interest: 43 points (+6 statistical-value points); traffic table 48 ports x 2010-2024 = 720 rows","data_date":"Calendar years 2010-2024 (no 2025 rows as of 2026-11-16)","caveats":["Consult the main caveats and the complete reading traps and access evidence in the detail."],"coverage":{"geographic":"State ports of general interest: 43 points (+6 statistical-value points); traffic table 48 ports x 2010-2024 = 720 rows"},"fine_print":{"unit":{"value":"Tonnes (cargo columns), TEU, number of ships, GT, number of passengers","quote":"2024 TRAFICO_TOTAL summed over the table = 557 774 946, equal to the Anuario 2025 line 'TOTAL 557.774.946' in tonnes (layer has no unit field or description)","url":"https://www.puertos.es/system/files/2026-10/Anuario%20Estadistico%20OPPE%202025.pdf","attempts":[]},"inclusion_rule":{"value":"The traffic of the ports that make up each Port Authority (view of the PdE statistics)","quote":"Vista con el trafico de los puertos que conforman las distintas autoridades portuarias","url":"https://www.arcgis.com/sharing/rest/content/items/704ed3fd57374514bab397f5b6b221ad?f=json","attempts":[]},"reference_date":{"value":"Calendar years 2010-2024 (no 2025 rows as of 2026-11-16)","quote":"Distinct Año values returned by the service: 2010..2024","url":"https://services9.arcgis.com/Ihvzfbme6HOduMK5/arcgis/rest/services/Trafico_Puertos_(Vista)/FeatureServer/0","attempts":[]},"update_frequency":{"value":null,"quote":null,"url":null,"attempts":["Layer/service metadata: no update frequency or description (checked FeatureServer JSON and item JSON)","Item modified 2023-07-31 (epoch 1690823368000) while data reach 2024 and the Anuario 2025 exists: not updated with the latest yearbook"]},"exclusions":{"value":null,"quote":null,"url":null,"attempts":["Layer and item metadata have no exclusions text","Same definitions as the Anuario apply (rank 1 fine print) but the service does not state them"]}},"key_fields":[{"field":"Trafico_Puertos: Año, Autoridad_Portuaria, Puerto","meaning":"Year, Port Authority (28 values), port (48 values)"},{"field":"Graneles_líquidos, Graneles_sólidos, Mercancía_general, Pesca, Avituallamiento, Tráfico_interior, TRÁFICO_TOTAL","meaning":"Tonnes by type"},{"field":"TEUS, Buques__nº_, Buques__GT_","meaning":"Containers, merchant ship calls (number), gross tonnage"},{"field":"Pasajeros_en_régimen_de_transpo, Pasajeros_de_crucero","meaning":"Non-cruise (regular line) and cruise passengers"},{"field":"Puertos_(Vista)/6: Puerto, Longitud, Latitud, Longitud0_Longitude, Tipo, autoridad_portuaria","meaning":"Port point (decimal degrees WGS84 via outSR=4326, and original degrees-minutes text); AP only filled for 2 of 43"}],"how_to_use":{"example_request":"curl -sG 'https://services9.arcgis.com/Ihvzfbme6HOduMK5/arcgis/rest/services/Trafico_Puertos_(Vista)/FeatureServer/0/query' --data-urlencode \"where=Año=2024 AND Puerto='Algeciras'\" --data-urlencode 'outFields=Año,Autoridad_Portuaria,Puerto,TRÁFICO_TOTAL,TEUS,Buques__nº_,Pasajeros_en_régimen_de_transpo,Pasajeros_de_crucero' --data-urlencode 'returnGeometry=false' --data-urlencode 'f=json'","example_result":"[{\"Año\":2024,\"Autoridad_Portuaria\":\"Bahía de Algeciras\",\"Puerto\":\"Algeciras\",\"TRÁFICO_TOTAL\":104132580,\"TEUS\":4712793,\"Buques__nº_\":27068,\"Pasajeros_en_régimen_de_transpo\":4620227,\"Pasajeros_de_crucero\":0}]. Points: .../Puertos_(Vista)/FeatureServer/6/query?where=Puerto='Valencia'&outSR=4326&f=json -> x -0.30167, y 39.44833","steps":["Count: .../Trafico_Puertos_(Vista)/FeatureServer/0/query?where=Año=2024&returnCountOnly=true&f=json returns 48; all 720 rows come in one call (maxRecordCount 1000/2000).","Get points: .../Puertos_(Vista)/FeatureServer/6/query?where=1=1&outFields=*&outSR=4326&f=json (43 points) plus .../Puertos_con_valor_estadístico_(Vista)/FeatureServer/6 (6 points).","Join points to traffic by port name after normalising: 'Bahía de Algeciras' (point) vs 'Algeciras' (traffic), 'Gijón-Musel' vs 'Gijón', 'La Estaca' vs 'La Estaca del Hierro', 'Puerto Rosario' vs 'Puerto del Rosario', trailing spaces ('Santander ').","Get the Port Authority from Trafico_Puertos.Autoridad_Portuaria, not from the points layer (autoridad_portuaria is null in 41 of 43)."],"reading_traps":["Table ends in 2024; the Anuario 2025 (rank 1) has 2025. 2024 total (557 774 946 t) equals the Anuario's 2024 figure.","Points layer: autoridad_portuaria null in 41 of 43 records; Tipo is 'Puertos Interes General' for all 43.","Port coordinates are arc-minute values converted to decimals (Latitud 43.35 = 43º21'N): precision about 1-2 km. 49 points tested: all inside Spain's bounding box; Arinaga is correct here (-15.406, 27.849), unlike the Anuario sheet 2_1.","Item description is empty and the service has no licence text; the ArcGIS item was last modified 2023 while data go to 2024."]},"test":{"tested_on":"2026-11-16","method":"api_query","http_status":200,"content_type":"application/json","size_bytes":null,"records_total":720,"records_for_country":720,"problems":[]},"evidence":[{"claim":"The corporate viewer uses these services","url":"https://www.arcgis.com/sharing/rest/content/items/59d21bbe70a746eba2e1fa33a9bab8a5/data?f=json","quote":"https://services9.arcgis.com/Ihvzfbme6HOduMK5/arcgis/rest/services/Trafico_Puertos_(Vista)/FeatureServer/0"},{"claim":"Traffic view description","url":"https://www.arcgis.com/sharing/rest/content/items/704ed3fd57374514bab397f5b6b221ad?f=json","quote":"Vista con el tráfico de los puertos que conforman las distintas autoridades portuarias"}],"members":[],"members_summary":null},{"source_id":"s003","name":"Resumen mensual del trafico portuario (CuadrosResumen_AAAA_MM.xlsx / PDF)","publisher":"Organismo Publico Puertos del Estado - Departamento de Estadistica","official":true,"landing_url":"https://www.puertos.es/datos/estadisticas/mensuales","data_url":"https://www.puertos.es/file-download/download/private/6351","access":"direct_download","format":"XLSX (45 sheets) and PDF","license":"unknown (aviso legal: written authorisation for reuse)","language":"es","has_coordinates":false,"location_precision":"none","publisher_type":"national_government","adds":"Monthly and year-to-date 2026 figures (latest September 2026) by Port Authority, incl. cruise-ship calls; fresher than ranks 1-2 but per authority, not per port.","first_seen_pass":1,"rank":3,"summary":"Resumen mensual del trafico portuario (CuadrosResumen_AAAA_MM.xlsx / PDF)","coverage_note":"28 Port Authorities (36 rows incl. headers/totals); months 2006-2026","data_date":"Month and year-to-date; latest file September 2026 (file dated 21/10/2026)","caveats":["Consult the main caveats and the complete reading traps and access evidence in the detail."],"coverage":{"geographic":"28 Port Authorities (36 rows incl. headers/totals); months 2006-2026"},"fine_print":{"unit":{"value":"Tonnes unless stated; ships, passengers in number; TEU","quote":"Datos en toneladas salvo indicacion expresa (sheet 'Resumen general' of CuadrosResumen_2026_09.xlsx); sheet 'Buques numero': Datos en numero","url":"https://www.puertos.es/datos/estadisticas/mensuales","attempts":[]},"inclusion_rule":{"value":"All Port Authorities managing ports of general interest, from the APs' monthly files","quote":"Ambito geografico: Datos de todas las Autoridades Portuarias que gestionan los puertos de interes general del estado espanol.","url":"https://www.puertos.es/datos/estadisticas/mensuales","attempts":[]},"reference_date":{"value":"Month and year-to-date; latest file September 2026 (file dated 21/10/2026)","quote":"Fecha: 21/10/2026 (cell I4 of 'Resumen general')","url":"https://www.puertos.es/file-download/download/private/6351","attempts":[]},"update_frequency":{"value":"Monthly, around the 25th of each month","quote":"Periodicidad: Mensual ... alrededor del dia 25 de cada mes.","url":"https://www.puertos.es/datos/estadisticas/mensuales","attempts":[]},"exclusions":{"value":null,"quote":null,"url":null,"attempts":["Monthly note lists variables (tonnes, UTI, TEU, ships number and GT, passengers, cars) but no exclusions text","Annual definitions (rank 1) apply but are not repeated in the monthly note"]}},"key_fields":[{"field":"Sheet 'Buques numero' A,B,C,D,E,F","meaning":"Port Authority, September 2025, September 2026, Jan-Sep 2025, Jan-Sep 2026, variation %"},{"field":"Sheets 'Pasajeros total/regulares/crucero', 'Total trafico', 'TEUS', 'Cruceros'","meaning":"Same layout for passengers, tonnes, TEU and cruise-ship calls"}],"how_to_use":{"example_request":"curl -sL -o CuadrosResumen_2026_09.xlsx 'https://www.puertos.es/file-download/download/private/6351' ; then read sheet 'Buques numero' (rows from 7) and 'Pasajeros total'","example_result":"'Buques numero' row 32: Valencia | Sep 2025 621 | Sep 2026 582 | Jan-Sep 2025 5472 | Jan-Sep 2026 5529 | +1.04%. 'Pasajeros total' row 32: Valencia 174795 | 141585 | 1316872 | 1152888 | -12.45%","steps":["Open the monthly page, pick the year, take the 'Descargar XLS' link (path /file-download/download/private/NNNN: returned 200 with no login).","Use sheets by topic; first column is the Port Authority; columns B-C the month (previous/current year), D-E year-to-date.","Sheet names have accents and trailing spaces; read them with a library that lists sheets."],"reading_traps":["Per Port Authority only (28), not per port, no coordinates.","Figures are provisional: the monthly page says data may be modified; the yearbook figures are the closed ones.","The link path says 'private' but downloads without login (tested 2026-11-16); numbers in the path change every month."]},"test":{"tested_on":"2026-11-16","method":"download","http_status":200,"content_type":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet","size_bytes":1218456,"records_total":28,"records_for_country":28,"problems":[]},"evidence":[{"claim":"Monthly summary content and cadence","url":"https://www.puertos.es/datos/estadisticas/mensuales","quote":"Objetivo: Presentacion resumida de la informacion mensual del trafico portuario de mercancias, de contenedores, de buques y de pasajeros de los puertos espanoles de interes general."}],"members":[],"members_summary":null},{"source_id":"s004","name":"Zonas de servicio portuarias de Espana (INSPIRE WFS/WMS: PortArea, FairwayArea)","publisher":"Puertos del Estado (INSPIRE catalogue of the Spanish State Administration)","official":true,"landing_url":"https://datos.gob.es/en/catalogo/e0dat0002-zonas-de-servicio-portuarias-de-espana1","data_url":"https://geoserver.puertos.es/geoserver/puertos/wfs","access":"api","format":"WFS 2.0.0 (GML, GeoJSON); WMS 1.3.0","license":"CC BY 4.0","language":"es","has_coordinates":true,"location_precision":"exact","publisher_type":"national_government","adds":"Official polygons (land service area and water zones I and II) per port with Port Authority code and delimitation date; no traffic.","first_seen_pass":1,"rank":4,"coverage":{"geographic":"State ports of general interest: PortArea 66 polygons, FairwayArea 98 polygons, 28 Port Authorities"},"fine_print":{"unit":{"value":null,"quote":null,"url":null,"attempts":["Field 'superficie' has no unit in the WFS schema or CSW record (checked WFS output and ISO record)","Sample values (Santander land zone 2843887) are consistent with square metres; not stated"]},"inclusion_rule":{"value":"Land service area and water zones I and II of the ports of general interest","quote":"La zona de servicio portuaria de los puertos de interes general del Estado, incluye la informacion cartografica y alfanumerica de la zona de servicio terrestre y de la zona I y II de aguas.","url":"https://www.idee.es/csw-codsi-idee/srv/api/records/spa_puertos_estado/formatters/xml","attempts":[]},"reference_date":{"value":"Continual update; metadata stamp 2025-04-03; latest act dates 2021-2025 per polygon (fecha_act)","quote":"La actualizacion de los datos es continua, conforme se van aprobando los expedientes de delimitacion y ordenacion del Dominio Publico Portuario","url":"https://www.idee.es/csw-codsi-idee/srv/api/records/spa_puertos_estado/formatters/xml","attempts":[]},"update_frequency":{"value":"Continual, as delimitation orders are approved","quote":"maintenanceAndUpdateFrequency codeListValue=continual","url":"https://www.idee.es/csw-codsi-idee/srv/api/records/spa_puertos_estado/formatters/xml","attempts":[]},"exclusions":{"value":null,"quote":null,"url":null,"attempts":["CSW record has no exclusions statement","Regional ports are outside the INSPIRE record (only 46 ports of general interest)"]}},"key_fields":[{"field":"ap, cod_ap","meaning":"Port Authority name and 2-letter code (28 values)"},{"field":"puerto, id_puerto, darsena","meaning":"Port name (51 distinct values incl. variants), id, basin"},{"field":"zona_servi / cod_zs","meaning":"Terrestre (PortArea) or Zona I / Zona II (FairwayArea)"},{"field":"superficie, act, fecha_act, nivel","meaning":"Area (no unit stated), last action (DEUP / Desafectacion), date dd/mm/yyyy, SUPERFICIE or SUBSUELO"},{"field":"cod_esc, escalas","meaning":"Intended ship-call fields: empty in all 164 features"}],"how_to_use":{"example_request":"https://geoserver.puertos.es/geoserver/puertos/wfs?SERVICE=WFS&VERSION=2.0.0&REQUEST=GetFeature&TYPENAMES=Puertos:TN.WaterTransportNetwork.PortArea&outputFormat=application/json&count=3  (count: same URL with &resultType=hits)","example_result":"hits: PortArea numberMatched=66, FairwayArea numberMatched=98. First feature: MultiPolygon EPSG:4258, properties {\"pig\":\"Santander\",\"puerto\":\"Santander\",\"zona_servi\":\"Terrestre\",\"superficie\":2843887,\"act\":\"Desafectacion\",\"fecha_act\":\"20/01/2021\",\"cod_ap\":\"ST\",\"ap\":\"Santander\"}","steps":["GetCapabilities lists 2 feature types: Puertos:TN.WaterTransportNetwork.PortArea and ...FairwayArea.","Download both as GeoJSON (8.0 MB and 10.4 MB; all features in one call).","Group by cod_ap/ap and puerto; compute centroids if a point is needed; unique port names must be normalised."],"reading_traps":["Names inconsistent: 51 distinct 'puerto' values vs 46 ports (Cadiz vs 'Cadiz y su bahia', Gijon without accent, 'Zona Franca' is not a port).","cod_esc and escalas (ship calls) are empty in all 164 features: there is no traffic in this service.","All 164 features fall inside the Spain bounding box (tested). CRS EPSG:4258."]},"test":{"tested_on":"2026-11-16","method":"api_query","http_status":200,"content_type":"application/json","size_bytes":8024525,"records_total":164,"records_for_country":164,"problems":[]},"evidence":[{"claim":"Content of the record","url":"https://datos.gob.es/en/catalogo/e0dat0002-zonas-de-servicio-portuarias-de-espana1","quote":"The port service areas include cartographic and alphanumeric information on the land service area and water zones I and II."}],"members":[],"members_summary":null},{"source_id":"s005","name":"Regional (non-state) port statistics: yearbooks and statistical offices of the regions","publisher":"Regional port agencies and regional statistical institutes","official":true,"landing_url":"https://ports.gencat.cat/es/datos-economicos-y-anuario-estadistico/","data_url":"http://ports.gencat.cat/wp-content/uploads/2026/04/Anuari_2025-1.pdf","access":"pdf","format":"PDF yearbooks; ISTAC REST API (SDMX)","license":"unknown (ISTAC: Aviso Legal)","language":"ca/es/gl","has_coordinates":false,"location_precision":"none","publisher_type":"regional_government","adds":"Commercial ports not managed by a state Port Authority (Palamos, Alcanar, Vilanova, Ribadeo, Canarias regional ports): cargo, calls and passengers that ranks 1-4 do not contain.","first_seen_pass":1,"rank":5,"coverage":{"geographic":"Sample: Catalonia (Ports de la Generalitat), Galicia (Portos de Galicia), Canarias regional ports (ISTAC). 4 of ~10 coastal regions opened; none national."},"fine_print":{"unit":{"value":"Tonnes, number of ships with GT (Catalonia)","quote":"Mercaderies ... Tones; Vaixells mercants Nre. / GT (Anuari 2025 pp.14, 18)","url":"http://ports.gencat.cat/wp-content/uploads/2026/04/Anuari_2025-1.pdf","attempts":[]},"inclusion_rule":{"value":null,"quote":null,"url":null,"attempts":["Catalonia yearbook table lists Gestio directa (Palamos, Vilanova, La Rapita) and Industrials (Alcanar) only; no rule text","Galicia summary names 7 commercial ports"]},"reference_date":{"value":"Calendar year 2025 (Catalonia, Galicia); ISTAC monthly to 2026","quote":"Evolucio nombre de tones en els ultims 5 exercicis: 2021 ... 2025 (Anuari 2025 p.19)","url":"http://ports.gencat.cat/wp-content/uploads/2026/04/Anuari_2025-1.pdf","attempts":[]},"update_frequency":{"value":"Annual (yearbooks); ISTAC monthly","quote":"Frecuencia de actualizacion Mensual (ISTAC operation C00061A page)","url":"https://www3.gobiernodecanarias.org/aplicaciones/operacionesistac/operations/C00061A","attempts":[]},"exclusions":{"value":null,"quote":null,"url":null,"attempts":["Not stated in the pages opened","Catalonia table distinguishes 'Industrials' ports (Alcanar) from direct management"]}},"key_fields":[{"field":"Catalonia p.18: Total port (t)","meaning":"Loaded + unloaded tonnes per port, by origin"},{"field":"ISTAC dimensions PUERTOS, SERVICIO_MARITIMO, TIME_PERIOD","meaning":"Port code (ESCUT...), maritime service, month (2011-M01...)"}],"how_to_use":{"example_request":"curl -sL -o anuari2025.pdf 'http://ports.gencat.cat/wp-content/uploads/2026/04/Anuari_2025-1.pdf' ; pdftotext -layout anuari2025.pdf a.txt ; grep -n 'Moviment de mercaderies per ports' a.txt (table at line 672). ISTAC: curl -sL 'https://datos.canarias.es/api/estadisticas/statistical-resources/v1.0/datasets/ISTAC/C00061A_000002/~latest.json'","example_result":"'Total port' Palamos 154.447 | Vilanova i la Geltru 24.754 | Alcanar 1.092.620 | Total general 1.271.821 (t). ISTAC JSON: dimensions TERRITORIO, TIME_PERIOD (204), PUERTOS (18), SERVICIO_MARITIMO (4); license field 'Aviso Legal'.","steps":["Catalonia: take the yearbook of the latest year from the transparency page; extract tables with pdftotext -layout.","ISTAC: GET the dataset ~latest.json; the observation string follows dimension order (Spanish numbers, empty = no data); port codes are ISTAC codes, not names in this call.","Galicia: only the summary page; ask the agency for port tables (not published in the memoria)."],"reading_traps":["Catalan thousands separator is a dot (154.447 = 154,447 t); the 'Total port' line sums loaded and unloaded goods.","ISTAC set is passengers (and vehicles by regional agency) only: no tonnes or ship calls.","Portos de Galicia memoria gives a total, not per port; do not divide it.","puertos.es lists the Valencia Port Authority memoria 2024 as a 1-page placeholder: 'Memoria de la Autoridad Portuaria pendiente de publicacion'."]},"test":{"tested_on":"2026-11-16","method":"download","http_status":200,"content_type":"application/pdf","size_bytes":4061485,"records_total":4,"records_for_country":4,"problems":[]},"evidence":[{"claim":"Galicia commercial ports","url":"https://ficheiros-web.xunta.gal/transparencia/memorias-balance-actividade/2025/portos.pdf","quote":"7 portos con actividade comercial Ribadeo, Cariño, Viveiro, Burela, A Pobra, Cee e Ribeira"},{"claim":"ISTAC scope","url":"https://www3.gobiernodecanarias.org/aplicaciones/operacionesistac/operations/C00061A","quote":"Ofrece información acerca de los movimientos de entrada y salida de pasajeros y mercancías en los puertos de Canarias"}],"members":[{"name":"Ports de la Generalitat de Catalunya - Anuari estadistic 2025","landing_url":"https://ports.gencat.cat/es/datos-economicos-y-anuario-estadistico/","data_url":"http://ports.gencat.cat/wp-content/uploads/2026/04/Anuari_2025-1.pdf","access":"pdf","tested":true,"data_found":null,"note":"p.18 'Moviment de mercaderies per ports': Palamos 154.447 t, Vilanova 24.754 t, Alcanar 1.092.620 t, total 1.271.821 t; p.14 merchant ships (Palamos 43, Alcanar 123, total 179); passengers p.29. Yearbooks 2021-2025 listed."},{"name":"Portos de Galicia - memoria de actividade 2025","landing_url":"https://ficheiros-web.xunta.gal/transparencia/memorias-balance-actividade/2025/portos.pdf","data_url":"https://ficheiros-web.xunta.gal/transparencia/memorias-balance-actividade/2025/portos.pdf","access":"pdf","tested":true,"data_found":null,"note":"Only system totals: 7 commercial ports (Ribadeo, Carino, Viveiro, Burela, A Pobra, Cee, Ribeira), 1.1 M t, Ribadeo 481.000 tn, 1.920.000 passengers; no table per port."},{"name":"ISTAC - Estadisticas de Transporte Maritimo (Puertos Canarios), dataset C00061A_000002","landing_url":"https://www3.gobiernodecanarias.org/aplicaciones/operacionesistac/operations/C00061A","data_url":"https://datos.canarias.es/api/estadisticas/statistical-resources/v1.0/datasets/ISTAC/C00061A_000002/~latest.json","access":"api","tested":true,"data_found":null,"note":"Monthly passengers by 18 regional ports and maritime service, 204 months from 2011; no cargo or calls."},{"name":"Idescat - Estadistica de transit maritim als ports (Catalonia aggregate)","landing_url":"https://idescat.cat/paae/2024/030703","data_url":null,"access":"pdf","tested":false,"data_found":null,"note":"Opened as a page: aggregates Ports de la Generalitat, Port de Barcelona and Port de Tarragona; points to their yearbooks."},{"name":"Agencia Publica de Puertos de Andalucia (APPA)","landing_url":"https://www.juntadeandalucia.es/organismos/appa.html","data_url":null,"access":"pdf","tested":false,"data_found":null,"note":"Page lists the ports it manages (Garrucha, Barbate, Adra...) and no statistics; none found in a search."}],"members_summary":{"total":null,"listed":5,"tested":3,"data_found":0,"scope_note":"Inherited members; data findings were not reclassified during this structural migration. Consult each member note.","pattern":null},"member_scope":{"total":null,"note":"Inherited members; data findings were not reclassified during this structural migration. Consult each member note.","pattern":null}},{"source_id":"s006","name":"Eurostat mar_go_am_es: Gross weight of goods transported to/from main ports - Spain","publisher":"Eurostat","official":true,"landing_url":"https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/dataflow/ESTAT/mar_go_am_es?detail=full","data_url":"https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/mar_go_am_es","access":"api","format":"JSON-stat / SDMX","license":"unknown (Eurostat reuse policy not opened)","language":"en","has_coordinates":false,"location_precision":"none","publisher_type":"supranational","adds":"Port-level goods (thousand tonnes, 2000-2025) that also names regional ports (Palamos, Garrucha, Alcanar, Agaete...) with UN/LOCODE-style codes; goods only.","first_seen_pass":1,"rank":6,"coverage":{"geographic":"Spain, 46 reporting areas/ports incl. regional ports and 4 sea regions"},"fine_print":{"unit":{"value":"Thousand tonnes (unit THS_T)","quote":"Query result: unit label 'Thousand tonnes'","url":"https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/mar_go_am_es","attempts":[]},"inclusion_rule":{"value":"Main ports: more than one million tonnes of goods or 200,000 passenger movements a year, or exceeded it in the last three years","quote":"Detailed information is collected from main ports - ports handling more than one million tonnes of goods annually or recording more than 200,000 passenger movements annually, as well as those that have exceeded this threshold in the last three years.","url":"https://ec.europa.eu/eurostat/cache/metadata/EN/mar_esms_ee.htm","attempts":[]},"reference_date":{"value":"Annual 2000-2025; updated 2026-10-07","quote":"TOC: mar_go_am_es 07.10.2026 2000 2025","url":"https://ec.europa.eu/eurostat/api/dissemination/catalogue/toc/txt?lang=en","attempts":[]},"update_frequency":{"value":"Annual (dataset updated 2026-10-07)","quote":"Last update 07.10.2026 in the Eurostat TOC","url":"https://ec.europa.eu/eurostat/api/dissemination/catalogue/toc/txt?lang=en","attempts":[]},"exclusions":{"value":null,"quote":null,"url":null,"attempts":["Spanish-specific metadata not opened (the metadata page opened is the Estonian one, same framework)","Algeciras 2025: Eurostat 78 209 kt vs Anuario goods 94 195 kt (liquid+solid+general) and 100 679 kt total: scope differs"]}},"key_fields":[{"field":"rep_mar","meaning":"Reporting port/area code, e.g. ES_2ESALG Algeciras, ES_2ESPAL Palamos"},{"field":"par_mar, direct, cargo, natvessr, unit","meaning":"Partner area, direction, cargo type, vessel nationality, unit"}],"how_to_use":{"example_request":"curl -sL 'https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/mar_go_am_es?format=JSON&lang=EN&freq=A&direct=TOTAL&cargo=TOTAL&natvessr=TOTAL&unit=THS_T&par_mar=TOTAL&time=2025&rep_mar=ES_2ESALG&rep_mar=ES_2ESVLC&rep_mar=ES_2ESBCN'","example_result":"value {0: 78209 (Algeciras), 1: 55859 (Barcelona), 2: 63421 (Valencia)} thousand tonnes, updated 2026-10-07","steps":["Without filters the call returns HTTP 413 (too big): filter freq, direct, cargo, natvessr, unit, par_mar and time.","List ports from dimension rep_mar (46 codes for 2023, 'ES_n' are sea regions)."],"reading_traps":["Not comparable with the Anuario totals (Algeciras 78.2 Mt vs 100.7 Mt): different scope.","Some ports have null values (Barbate, San Carlos de la Rapita, Vilanova i la Geltru in 2023).","No Eurostat passenger or vessel-call dataset at port level for Spain was found in the TOC (only country level)."]},"test":{"tested_on":"2026-11-16","method":"api_query","http_status":200,"content_type":"application/json","size_bytes":5736,"records_total":46,"records_for_country":46,"problems":[]},"evidence":[{"claim":"Dataset exists for Spain, updated 2026","url":"https://ec.europa.eu/eurostat/api/dissemination/catalogue/toc/txt?lang=en","quote":"Gross weight of goods transported to/from main ports - Spain\t\"mar_go_am_es\"\t\"dataset\"\t\"07.10.2026\""}],"members":[],"members_summary":null},{"source_id":"s007","name":"OpenStreetMap harbour/port features (via Nominatim; Overpass not reachable)","publisher":"OpenStreetMap contributors","official":false,"landing_url":"https://nominatim.openstreetmap.org/","data_url":null,"access":"api","format":"JSON","license":"ODbL 1.0","language":"es","has_coordinates":true,"location_precision":"exact","publisher_type":"community","adds":"Crowd-sourced port locations and areas for any port incl. regional ones; no port authority or traffic.","first_seen_pass":1,"rank":7,"coverage":{"geographic":"Worldwide; Spain tested with one port"},"fine_print":{"unit":{"value":null,"quote":null,"url":null,"attempts":["Not applicable: location only","Nominatim result has lat/lon and boundingbox"]},"inclusion_rule":{"value":null,"quote":null,"url":null,"attempts":["No inclusion rule: community tagging (landuse=harbour etc.)","Taginfo shows landuse=port has only 2 uses worldwide, so the tag in use is another one"]},"reference_date":{"value":null,"quote":null,"url":null,"attempts":["Live data","Taginfo data_until 2026-11-16"]},"update_frequency":{"value":null,"quote":null,"url":null,"attempts":["Continuous community edits","No schedule"]},"exclusions":{"value":null,"quote":null,"url":null,"attempts":["No exclusions stated","Commercial/fishing/marina not distinguished in the test"]}},"key_fields":[{"field":"osm_type, osm_id, category, type, boundingbox","meaning":"relation 13533567, category landuse, type harbour, boundingbox of the Valencia port"}],"how_to_use":{"example_request":"curl -s 'https://nominatim.openstreetmap.org/search?q=Puerto+de+Valencia&format=jsonv2&limit=2'","example_result":"[{\"osm_type\":\"relation\",\"osm_id\":13533567,\"lat\":\"39.4430124\",\"lon\":\"-0.3180002\",\"category\":\"landuse\",\"type\":\"harbour\",\"name\":\"Puerto de Valencia\",\"boundingbox\":[\"39.4206158\",\"39.4653218\",\"-0.3361556\",\"-0.2857612\"]}]","steps":["Overpass (nwr[landuse=harbour] or [harbour=yes] in area ES) would give all of them but the 3 public endpoints tried (overpass-api.de refused connection, private.coffee no response, maps.mail.ru 504) did not answer from this host.","Use Nominatim per name only for spot checks, not bulk."],"reading_traps":["Overpass was not usable here, so no count of Spanish ports is given.","OSM has no Port Authority or commercial/regional flag."]},"test":{"tested_on":"2026-11-16","method":"api_query","http_status":200,"content_type":"application/json","size_bytes":null,"records_total":1,"records_for_country":1,"problems":["Overpass endpoints overpass-api.de (connection refused), overpass.private.coffee (no response) and maps.mail.ru (504) did not answer on 2026-11-16"]},"evidence":[{"claim":"Nominatim returns the Valencia port as a harbour relation","url":"https://nominatim.openstreetmap.org/search?q=Puerto+de+Valencia&format=jsonv2&limit=1","quote":"\"category\":\"landuse\",\"type\":\"harbour\",\"name\":\"Puerto de Valencia\""}],"members":[],"members_summary":null},{"source_id":"s008","name":"IMF PortWatch - Ports database (ArcGIS FeatureServer)","publisher":"International Monetary Fund / University of Oxford PortWatch team","official":false,"landing_url":"https://www.arcgis.com/home/item.html?id=acc668d199d1472abaaf2467133d4ca4","data_url":"https://services9.arcgis.com/weJ1QsnbMYJlCHdG/arcgis/rest/services/PortWatch_ports_database/FeatureServer/0","access":"api","format":"ArcGIS REST JSON","license":"IMF terms (https://www.imf.org/external/terms.htm)","language":"en","has_coordinates":true,"location_precision":"exact","publisher_type":"supranational","adds":"38 Spanish ports (incl. non-state Garrucha, Torrevieja, Rota) with AIS-derived average ship counts and LOCODE; estimates, not authority statistics.","first_seen_pass":1,"rank":8,"coverage":{"geographic":"Worldwide; Spain 38 ports"},"fine_print":{"unit":{"value":"Yearly average number of ships calling (AIS), total and by 5 types","quote":"we use real-time data on vessel movements - Automatic Identification System (AIS) signals of vessels - to calculate the yearly average number of ships flowing through the port, over the timeframe 2019-2025","url":"https://www.arcgis.com/sharing/rest/search?q=title:PortWatch%20ports%20database","attempts":[]},"inclusion_rule":{"value":null,"quote":null,"url":null,"attempts":["Item description explains systemic-port classification, not a size cut-off for the list","Layer returns 38 Spanish ports incl. small ones"]},"reference_date":{"value":"Average over 2019-2025","quote":"over the timeframe 2019-2025","url":"https://www.arcgis.com/sharing/rest/search?q=title:PortWatch%20ports%20database","attempts":[]},"update_frequency":{"value":null,"quote":null,"url":null,"attempts":["Item description has no frequency","PortWatch methodology page is JavaScript-rendered and returned only its heading"]},"exclusions":{"value":null,"quote":null,"url":null,"attempts":["Not stated in the item description","Algeciras 5899 average vs 26241 calls in the Anuario 2025: not comparable"]}},"key_fields":[{"field":"portname, LOCODE, lat, lon, vessel_count_total, vessel_count_container...","meaning":"Port, UN/LOCODE (null for some, e.g. Las Palmas), position, average ships per year by type"}],"how_to_use":{"example_request":"curl -sG 'https://services9.arcgis.com/weJ1QsnbMYJlCHdG/arcgis/rest/services/PortWatch_ports_database/FeatureServer/0/query' --data-urlencode \"where=ISO3='ESP'\" --data-urlencode 'outFields=portid,portname,lat,lon,vessel_count_total,vessel_count_container,LOCODE' --data-urlencode 'returnGeometry=false' --data-urlencode 'f=json'","example_result":"count 38. Algeciras port31 36.1659,-5.4143 vessel_count_total 5899 LOCODE 'ES ALG'; Valencia port1348 39.4422,-0.3223 total 3897","steps":["The service answers HTTP 429 when the shared quota is exceeded (several attempts failed over about 25 minutes); wait and retry."],"reading_traps":["Estimates from AIS, not authority call counts: Algeciras 5899 vs 26241 in the Anuario 2025.","Position given to 8 decimals but it is a port-level point of a global database, not surveyed.","No Port Authority and no cargo or passenger data."]},"test":{"tested_on":"2026-11-16","method":"api_query","http_status":200,"content_type":"application/json","size_bytes":null,"records_total":null,"records_for_country":38,"problems":["HTTP 429 (quota per minute exceeded) on several attempts before it answered"]},"evidence":[{"claim":"Vessel count definition","url":"https://www.arcgis.com/sharing/rest/search?q=title:PortWatch%20ports%20database","quote":"we use real-time data on vessel movements—Automatic Identification System (AIS) signals of vessels— to calculate the yearly average number of ships flowing through the port, over the timeframe 2019-2025"}],"members":[],"members_summary":null}],"sector":{"regulator":{"name":"Organismo Publico Puertos del Estado (Ministerio de Transportes y Movilidad Sostenible)","url":"https://www.puertos.es/en"},"operators":{"structure":"many","note":"28 Port Authorities manage the 46 state ports; regional agencies (Ports de la Generalitat, Portos de Galicia, APPA, Puertos Canarios, PortsIB...) run non-state ports; terminals are private concessions.","census_url":"https://www.puertos.es/en"},"publication_obligation":{"exists":"yes","norm":"Real Decreto Legislativo 2/2011 (TRLPEMM), art. 18","url":"https://www.boe.es/eli/es/rdlg/2011/09/05/2/con/20250129","what_must_be_published":"Art. 18.2: 'Las Autoridades Portuarias suministraran a dicho Organismo Publico la informacion que les sea requerida'; art. 18.1.n gives Puertos del Estado 'Elaborar las estadisticas de trafico'. It obliges APs to supply data to PdE, not to publish.","frequency":"Monthly submissions to Puertos del Estado; annual yearbook (October)"},"consolidated_republication":{"found":"yes","note":"Puertos del Estado republishes what the 28 APs report (yearbook, monthly summary, ArcGIS layers). Regional ports: Idescat aggregates Catalonia, ISTAC aggregates Canarias passengers; no national aggregator.","checked_pages":[{"organization":"Puertos del Estado","url":"https://www.puertos.es/en/data/statistics/annual","saw":"Annual yearbooks 2020-2025 (PDF) and Memorias of the 28 Port Authorities"},{"organization":"Puertos del Estado","url":"https://www.puertos.es/datos/estadisticas/mensuales","saw":"Monthly summary XLSX/PDF; method note: APs send monthly files, PdE validates and aggregates"},{"organization":"Puertos del Estado","url":"https://experience.arcgis.com/experience/59d21bbe70a746eba2e1fa33a9bab8a5/page/VISOR/","saw":"Corporate viewer; its data.json names the FeatureServers with port points and traffic table"}]}},"national_registry":{"exists":"partial","note":"The only official list is the 46 ports of general interest (TRLPEMM annex I) with PdE service-zone layers; no national registry covers regional ports.","checked_pages":[{"organization":"Agencia Estatal Boletin Oficial del Estado","url":"https://www.boe.es/eli/es/rdlg/2011/09/05/2/con/20250129","saw":"Art. 4.1: 'Son puertos de interes general los que figuran en el anexo I'; regional ports under regional competence"},{"organization":"Puertos del Estado","url":"https://www.puertos.es/en","saw":"Homepage lists the 28 Port Authorities; no list of regional ports"},{"organization":"datos.gob.es (open data portal)","url":"https://datos.gob.es/en/catalogo/e0dat0002-zonas-de-servicio-portuarias-de-espana1","saw":"Service zones of the state ports only (INSPIRE), WMS/WFS"},{"organization":"Eurostat","url":"https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/dataflow/ESTAT/mar_go_am_es?detail=full","saw":"Dataflow for Spain lists statistical ports incl. regional ones (Palamos, Garrucha, Alcanar)"},{"organization":"Ports de la Generalitat de Catalunya","url":"https://ports.gencat.cat/es/datos-economicos-y-anuario-estadistico/","saw":"Only its own ports (Palamos, Vilanova, La Rapita, Alcanar...)"}]},"if_unstructured":{"summary":null,"recipe":["Official state ports: use rank 2 (API) for 2010-2024 and rank 1 XLSX for 2025; no manual work needed.","Regional ports of Catalonia: open the latest Anuari PDF (tested 2025), run pdftotext -layout, find 'Moviment de mercaderies per ports' (cargo, line 672), 'Vaixells mercants' (calls, p.14) and 'Passatgers per tipologia de trafic' (p.29); Catalan numbers use dot as thousands separator.","Other regions: find the regional port agency's yearbook/memoria; Galicia's 2025 memoria only gives system totals; Andalucia APPA page lists ports but no statistics (not found).","Zone vertices of a state port: BOE order with ETRS89/REGCAN95 UTM coordinates (tested for Marin TMA/690/2023): transform with the stated CRS (huso 29 for Marin)."],"location_method":"State ports: rank 2 points (arc-minute) or rank 4 polygons. Regional ports: no coordinates found; use the region's cartography or OSM (rank 7, spot checks only).","cross_with":["Rank 4 polygons by cod_ap/puerto to validate rank 2 points","Eurostat rank 6 for regional port names","UN/LOCODE column in rank 8 for joining"],"where_published":[{"name":"Memoria anual / memoria estadistica of each Port Authority (via puertos.es)","url":"https://www.puertos.es/en/data/statistics/annual","what":"PDF per AP with traffic tables, quay lists and location; 28 links on the annual page","how_to_search_inside":"Pick the AP from the table; pdftotext -layout; search index entries Trafico/Buques/Pasajeros. Some are placeholders (Valencia 2024 is a 1-page notice).","example_document":{"url":"https://www.puertos.es/system/files/2025-09/Memoria%20Anual%202024%20AP%20Barcelona.pdf","what_it_gives":"Memoria estadistica 2024 Port de Barcelona (102 pp): 'Longitud 2º 10' E / Latitud 41º 21' N'; section 4.1.1 Pasajeros, 4.2.1 Buques mercantes; quays with length, draught and use"}},{"name":"BOE - Ordenes TMA of delimitacion de espacios y usos portuarios","url":"https://www.boe.es/buscar/","what":"Ministerial orders with UTM vertex coordinates of each port service zone","how_to_search_inside":"BOE search by title text 'delimitacion de los espacios y usos portuarios' and the port name; vertices are in the order annex","example_document":{"url":"https://www.boe.es/boe/dias/2023/06/27/pdfs/BOE-A-2023-15047.pdf","what_it_gives":"Orden TMA/690/2023, Marin y Ria de Pontevedra: 'coordenadas UTM (ETRS89, huso 29)' of the land service zone; (Santa Cruz de La Palma, TMA/692/2023: REGCAN95 / UTM)"}},{"name":"Ports de la Generalitat - Anuari estadistic","url":"https://ports.gencat.cat/es/datos-economicos-y-anuario-estadistico/","what":"Yearbooks 2021-2025 with cargo, ships and passengers of its ports","how_to_search_inside":"Table of contents; Moviment de mercaderies per ports","example_document":{"url":"http://ports.gencat.cat/wp-content/uploads/2026/04/Anuari_2025-1.pdf","what_it_gives":"p.18: 'Total port' Palamos 154.447; Vilanova i la Geltru 24.754; Alcanar 1.092.620"}}]},"related_not_answering":[{"name":"Eurostat country-level maritime datasets (mar_mg_aa_cwh, mar_mp_aa_cph)","url":"https://ec.europa.eu/eurostat/api/dissemination/catalogue/toc/txt?lang=en","why":"National totals per country, not per port."},{"name":"Datos abiertos: Estadisticas de trafico maritimo (Autoridad Portuaria de Baleares)","url":"https://datos.gob.es/ca/catalogo/ea0001301-estadisticas-de-trafico-maritimo","why":"Only distribution listed is a PNG image; its site seu.portsdebalears.gob.es answers with a Cloudflare challenge and the five ports are already in ranks 1-2."},{"name":"Portos de Galicia memoria 2025 system totals","url":"https://ficheiros-web.xunta.gal/transparencia/memorias-balance-actividade/2025/portos.pdf","why":"Regional totals (1.1 M t) are not per-port cargo."}],"open_questions":["Anuario 2025 glossary says gross weight excludes tares while table footnotes say tares are included: needs Puertos del Estado to clarify.","Eurostat mar_go_am_es gives Algeciras 78 209 kt for 2025 and the Anuario 100 679 kt (94 195 kt without supplies/fish/local): the reconciliation is not published in the pages opened.","Anuario sheet 2_1 Arinaga longitude (25º24'O) conflicts with the ArcGIS layer (15º23'O): which is the official value needs confirming with Puertos del Estado."],"history":[{"pass":1,"date":"2026-11-16","role":"research","model":"Claude Sonnet 5.5 (High)","rules_version":"6.12","note":"First pass: state ports fully answered (yearbook XLSX + ArcGIS API); regional ports only sampled (Catalonia, Galicia, Canarias).","headline":{"official_data":"partial","non_official_data":"partial","national_registry":"partial"},"sources":{"total":8,"new":8,"dropped":0},"negatives":{"overturned":0,"confirmed":0},"effort":{"pages":36,"minutes":40}}],"local_terms":[{"term":"puerto de interes general","language":"es","meaning":"State-owned commercial port listed in annex I of the TRLPEMM (46)"},{"term":"Autoridad Portuaria (AP)","language":"es","meaning":"Public body managing one or more state ports (28)"},{"term":"puerto autonomico / de competencia autonomica","language":"es","meaning":"Port not of general interest, run by a region"},{"term":"escala","language":"es","meaning":"Ship call (statistics count calls, not unique ships)"},{"term":"trafico portuario","language":"es","meaning":"Tonnes of goods handled (loaded, unloaded, transit, transhipment)"},{"term":"zona de servicio / DEUP","language":"es","meaning":"Service zone; Delimitacion de Espacios y Usos Portuarios (ministerial order)"},{"term":"Anuario Estadistico / Memoria anual","language":"es","meaning":"Yearbook of Puertos del Estado / annual report of each AP"},{"term":"GT (arqueo bruto), TEU","language":"es","meaning":"Gross tonnage; 20-foot container equivalent"}],"provenance":{"pass_count":1,"models":["Claude Sonnet 5.5 (High)"],"minutes_estimate":40,"pages_opened":36,"passes":[{"pass":1,"date":"2026-11-16","model":"Claude Sonnet 5.5 (High)"}],"note":"Minutes are researcher estimates. Counts describe documented passes, not publication approval. Missing history or effort is not reconstructed."},"card_url":"https://georutter.org/v1/es/ports.json","detail_url":"https://georutter.org/v1/es/ports/detail.json","html_url":"https://georutter.org/es/ports/","country_url":"https://georutter.org/v1/countries/es.json"}
