mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-04 18:34:02 +00:00
TeleGeography stores 17 cables (2Africa, Echo, Hawaiki...) as several features under one id, and the tool made a row per feature, so "Echo" read "3 submarine cables" and area counts ran high. Rows are now unique by cable id, and a cable still matches when any of its parts does.
107 lines
3.5 KiB
JavaScript
107 lines
3.5 KiB
JavaScript
/** Submarine cables and their landing points. */
|
|
|
|
import { suggestView } from '../views.js';
|
|
import { defineTool, ToolError } from '../catalog.js';
|
|
import {
|
|
AREA_SCHEMA,
|
|
areaContains,
|
|
lineTouchesArea,
|
|
resolveArea,
|
|
} from '../area.js';
|
|
import { LIMIT_SCHEMA, capRows, countNoun } from '../results.js';
|
|
|
|
const ATTRIBUTION = '© TeleGeography — submarinecablemap.com (CC BY-NC-SA 3.0)';
|
|
|
|
function cableLines(feature) {
|
|
const geometry = feature?.geometry;
|
|
if (geometry?.type === 'LineString') return [geometry.coordinates];
|
|
if (geometry?.type === 'MultiLineString') return geometry.coordinates;
|
|
return [];
|
|
}
|
|
|
|
export const findSubmarineCables = defineTool({
|
|
name: 'find_submarine_cables',
|
|
title: 'Submarine cables',
|
|
description:
|
|
'Undersea telecommunication cables and landing points from the ' +
|
|
'TeleGeography map: those passing through or landing in an area, ' +
|
|
'and/or those whose name matches.',
|
|
inputSchema: {
|
|
type: 'object',
|
|
properties: {
|
|
area: AREA_SCHEMA,
|
|
name: { type: 'string', minLength: 2, maxLength: 80 },
|
|
limit: LIMIT_SCHEMA,
|
|
},
|
|
additionalProperties: false,
|
|
},
|
|
requires: ['cables'],
|
|
async run(args, { services, signal }) {
|
|
if (!args.area && !args.name)
|
|
throw new ToolError('invalid_arguments', 'Give an area, a name or both');
|
|
const area = args.area
|
|
? await resolveArea(args.area, { services, signal })
|
|
: null;
|
|
const wanted = args.name?.toLowerCase();
|
|
const { cables, landingPoints } = await services.cables.fetch(signal);
|
|
const landingRows = (landingPoints?.features || [])
|
|
.map((feature) => ({
|
|
id: feature.properties?.id ?? null,
|
|
name: feature.properties?.name ?? null,
|
|
lon: feature.geometry?.coordinates?.[0],
|
|
lat: feature.geometry?.coordinates?.[1],
|
|
}))
|
|
.filter(
|
|
(point) =>
|
|
point.name &&
|
|
Number.isFinite(point.lat) &&
|
|
(!area || areaContains(area, point)),
|
|
);
|
|
const seen = new Set();
|
|
const rows = (cables?.features || [])
|
|
.filter((feature) => {
|
|
const name = String(feature.properties?.name || '');
|
|
if (!name || (wanted && !name.toLowerCase().includes(wanted)))
|
|
return false;
|
|
return (
|
|
!area ||
|
|
cableLines(feature).some((line) => lineTouchesArea(line, area))
|
|
);
|
|
})
|
|
.map((feature) => ({
|
|
id: feature.properties.id ?? null,
|
|
name: feature.properties.name,
|
|
}))
|
|
// TeleGeography splits some cables into several features under one id.
|
|
.filter((row) => {
|
|
const key = row.id ?? row.name;
|
|
return !seen.has(key) && seen.add(key);
|
|
})
|
|
.sort((a, b) => a.name.localeCompare(b.name));
|
|
const where = area ? ` in ${area.label}` : '';
|
|
const what = wanted ? ` matching "${args.name}"` : '';
|
|
return {
|
|
summary:
|
|
`${countNoun(rows.length, 'submarine cable')}${what}${where}` +
|
|
(area
|
|
? `, with ${countNoun(landingRows.length, 'landing point')}.`
|
|
: '.'),
|
|
data: {
|
|
view: suggestView(
|
|
services,
|
|
area
|
|
? { area, layers: ['telegeography-submarine-cables'] }
|
|
: {
|
|
point: { lat: 20, lon: 0 },
|
|
altitudeM: 15_000_000,
|
|
layers: ['telegeography-submarine-cables'],
|
|
},
|
|
),
|
|
...capRows(rows, args.limit),
|
|
landing_points: area ? capRows(landingRows, args.limit) : null,
|
|
attribution: ATTRIBUTION,
|
|
},
|
|
};
|
|
},
|
|
});
|