Numlex Documentación
Referencia

Datos en vivo y geografía

Consultas del tiempo, geocodificación, distancia (Haversine) y sintaxis DMS/grados decimales, con comportamiento offline y privacidad.

Cinco plantillas estrictas del tiempo y otras plantillas geográficas salen del Mac: location of <place>, latitude/longitude of <place> y distance between <end1> and <end2>. Cada una es estricta: si la línea no coincide exactamente, no se envía nada a ningún sitio.

Esta página cubre las plantillas del tiempo, las plantillas de geografía (lugares con nombre y coordenadas explícitas), la distancia, la sintaxis DMS/grados decimales y las reglas de privacidad que se aplican a cada petición. Los resultados dependientes de datos externos se marcan como dinámicos en todo momento.

Tiempo

Las cinco plantillas exactas (sin distinguir mayúsculas y con espacios flexibles) son:

weather in <place>
<place> temperature
high in <place>
low in <place>
feels like in <place>

<place> es texto libre de hasta 100 caracteres. Se permite puntuación segura para escribir nombres ambiguos con naturalidad: New York, Paris, France, St. Louis, Côte d'Ivoire.

Lo siguiente hace que la línea no sea una petición del tiempo (se trata como texto normal): normal):

  • un valor de lugar vacío,
  • caracteres de control,
  • marcadores de token de respuesta,
  • #, =,
  • operadores: + - * / × ÷ − ^ % ( ).

Las dos primeras formas devuelven la temperatura actual; high y low, la máxima y mínima de hoy; feels like, la temperatura aparente actual. Todos los resultados se expresan en °C (C°) y son dinámicos.

  • Proveedor: Open-Meteo, sin clave.
  • Caché: Una última respuesta correcta por lugar sirve las cuatro mediciones; su TTL es de 600 segundos y después se actualiza en segundo plano.
  • Sin conexión: El último valor en caché sigue disponible; sin ninguna lectura, la línea informa Weather unavailable.
  • Privacidad: Solo se envía el nombre del lugar; nunca se usa el GPS.

Geografía

Las plantillas exactas son (sin distinguir mayúsculas):

location of <place>
latitude of <place>
longitude of <place>
distance between <end1> and <end2>

Cada extremo de distance between puede ser:

  • un nombre de lugar, resuelto por el geocodificador (dinámico), o
  • coordenadas explícitas, que se resuelven sin conexión y sin ninguna petición de red.

Un nombre sin comillas se divide por el último and independiente de la línea. Por eso se admiten — y se recomiendan — las comillas para nombres que contienen and:

distance between "Rock and Roll Hall" and Vienna

Una comilla suelta o desequilibrada saca la línea por completo de la gramática geográfica.

Los extremos de coordenadas se escriben <latitude>, <longitude>. En una configuración regional con punto decimal el separador es una coma; en una con coma decimal la pareja usa un punto y se separa con punto y coma (;). Rangos válidos: latitud −90…90, longitud −180…180.

Semántica de la distancia

distance between calcula una distancia de superficie Haversine: la distancia directa de círculo máximo, no una ruta en coche ni en avión.

  • Radio de la Tierra: el radio medio terrestre.
  • Las distancias de 1000 m o más se muestran en kilómetros.

Detalles de la geocodificación:

  • Proveedor: Open-Meteo, usando solo el punto final de geocodificación; se usa el resultado mejor clasificado y no se pide pronóstico ni clave.
  • Sin conexión: un lugar ya resuelto se reutiliza; si no, Location unavailable.
  • Privacidad: solo se envía el nombre del lugar. La posición GPS del dispositivo nunca se usa.

DMS / grados decimales

Una línea se trata como grados cuando se cumple alguna de estas condiciones:

  • la línea termina en as DMS o as decimal;
  • lleva componentes de primo/doble primo (notación DMS);
  • un dígito o signo está inmediatamente antes de ° (forma de grado decimal, incluido un cardinal final).

Los glifos de temperatura (C°, F°, K°, R°, siempre tras una letra) son temperaturas y no grados.

FormaEjemploValor
Grado decimal51.5074°51.5074
+ cardinal51.5° N, 0.1275° Wsigno por N/S/E/W (S y W negativos)
DMS156° 44′ 31.2″156 + 44/60 + 31.2/3600
DMS parcial156° 44′grados + minutos, sin segundos
… as DMS51.25° as DMS→ 51° 15′ 0″
… as decimal156° 44′ 31.2″ as decimal→ 156.7419…

Límites y reglas:

  • Los minutos y segundos van de 0…59.
  • Los segundos aceptan hasta dos dígitos decimales en la entrada (31.25″) y se muestran con uno (31.2″).
  • Los glifos son solo ° ′ ″ (U+00B0, U+2032, U+2033). El ' y '' ASCII no son glifos.
  • El orden de los glifos es fijo — el primero solo °, el segundo solo ′, el tercero solo ″ — y hay 2–3 componentes.
  • Las cadenas de dígitos sin glifos (156 44 31) no se convierten en DMS: esa línea no se trata como grados. (Con un sufijo as decimal se usa la forma de enteros.) A la izquierda de as DMS / as decimal se exige un número decimal o una notación con al menos un glifo.
  • Un cardinal solo se acepta con un grado decimal puro (51.5° N); la notación DMS con cardinal (156°44′31″ W) es un error.
  • Presentación: 156° 44′ 31.2″ (segundos enteros sin .0; en una configuración con coma decimal, 31,2″; los negativos con − inicial).

Resultados dinámicos

El tiempo, las ubicaciones geocodificadas y las distancias que dependen de ellas proceden de datos externos y cambian con el tiempo. Todo lo demás de esta página — las distancias por coordenadas y la conversión DMS — se calcula localmente.

Relacionado

¿Has encontrado un error en esta documentación? Infórmalo en GitHub