ForHosting KIT · Viajes y geografía

Punto en polígono

El punto (1, 1) está dentro del rectángulo con esquinas (0, 0), (4, 0), (4, 3) y (0, 3): un rayo lanzado hacia la derecha cruza su contorno una vez, y un número impar significa dentro. Sirve igual en sentido horario o antihorario. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto

Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.

Una prueba de punto en polígono responde a una pregunta básica de geometría computacional: dada una ubicación de consulta y una forma cerrada definida por un anillo ordenado de vértices, ¿cae esa ubicación en el interior de la forma? Topografía, productos cartográficos, máscaras de colisión en juegos, geovallas logísticas y laboratorios de geometría en clase necesitan la misma respuesta determinista en lugar de un croquis a mano. Este comprobador implementa el algoritmo clásico de ray casting par-impar en coordenadas planas: se lanza un semirayo horizontal desde el punto de prueba hacia el infinito positivo, se prueba cada arista del polígono en busca de un cruce propio, y la paridad del recuento de cruces decide dentro frente a fuera. Los puntos que caen exactamente sobre una arista o vértice se tratan como dentro y se marcan con un indicador de contorno para que los consumidores de conjunto cerrado no necesiten un segundo paso. El polígono se cierra de forma implícita —no es necesario repetir el primer vértice al final— y los vértices pueden suministrarse como objetos con campos x e y o como arrays de dos elementos. Cuando se proporcionan menos de tres vértices la petición falla con un error de validación claro, porque un polígono necesita al menos un triángulo.

Cómo funciona la prueba de ray casting par-impar

Parta de un punto de consulta finito con coordenadas x e y y de una lista ordenada de al menos tres vértices planos que forman un polígono simple cerrado al conectar vértices consecutivos y unir el último al primero. El algoritmo no exige orden horario o antihorario; ambas orientaciones son válidas bajo la regla par-impar. Desde el punto de consulta, imagine un rayo horizontal que solo viaja a la derecha, nunca a la izquierda.

Recorra cada arista del polígono y decida si esa arista cruza el rayo. Las aristas horizontales se ignoran para no crear dobles conteos ambiguos. Cuando una arista monta la altura del rayo —un extremo estrictamente por encima de la y de consulta y el otro no— se calcula la x exacta de la intersección con un parámetro lineal a lo largo de la arista.

Si la x de consulta queda estrictamente a la izquierda de esa intersección, la arista aporta un cruce; si la intersección coincide con la consulta dentro de una tolerancia numérica diminuta, el punto se clasifica como sobre el contorno. Tras procesar todas las aristas, un recuento impar de cruces significa dentro y un recuento par significa fuera, el argumento clásico de paridad de la curva de Jordan especializado a un rayo horizontal. Las coordenadas deben ser finitas; NaN e Infinity se rechazan.

Dónde aparecen las comprobaciones de punto en polígono en el trabajo real

Los productos de logística y entrega preguntan si una fijación GPS de mensajero cae dentro de un polígono de barrio antes de ofrecer una tarifa por zona, y necesitan una respuesta determinista que no derive entre la vista previa del mapa en el navegador y el servidor. Juegos y medios interactivos usan máscaras de colisión alineadas a ejes o de forma libre definidas como anillos de vértices y prueban posiciones de jugador o proyectil cada fotograma sin arrastrar un stack SIG pesado.

Los módulos de geometría computacional en clase enseñan ray casting, la intuición del teorema de la curva de Jordan y casos límite de punto flotante; un oráculo confiable único que devuelve tanto el indicador inside como el recuento bruto de cruces ayuda a los estudiantes a verificar deberes paso a paso. Herramientas de planificación urbana y catastro clasifican puntos de muestra frente a huellas de edificios o polígonos de zonificación en revisiones de diseño tempranas cuando aún no hay bases de topología completas.

Si más adelante necesita perímetro de polígono, área de polígono, geodesia de gran círculo, agujeros multipolígono con la regla de winding no nulo o contención esférica en el elipsoide WGS84, trátelos como intenciones de búsqueda y aterrizajes separados en lugar de sobrecargar esta página del comprobador plano de punto en polígono.

Pertenencia a geovalla para logística

Clasifique puntos GPS o de clic en el mapa frente a zonas de entrega y polígonos de barrio con un indicador inside determinista compartido por vistas previas del navegador y precios del backend.

Pruebas de impacto en juegos e interfaz

Compruebe si un cursor, jugador o proyectil está dentro de una máscara poligonal de forma libre sin importar una biblioteca SIG completa al cliente.

¿Qué algoritmo usa este comprobador de punto en polígono?

Ray casting par-impar: un semirayo horizontal desde el punto de consulta cuenta cruces con las aristas del polígono; impar significa dentro, par significa fuera.

¿Qué ocurre si el polígono tiene menos de tres vértices?

Un polígono necesita al menos tres vértices; un segmento o un solo punto no es un anillo válido para contención.

¿Importa el orden de los vértices (horario frente a antihorario)?

Cualquiera de las dos orientaciones funciona bajo la regla par-impar. El orden debe seguir siendo secuencial alrededor del contorno; revolver vértices produce una forma distinta (normalmente autointersecante).

¿Cuánto cuesta?

La herramienta del navegador es gratuita y se ejecuta localmente.

¿Qué pasa si el punto cae justo sobre el borde?

Un punto situado exactamente sobre un lado o un vértice cuenta como dentro, y el resultado indica además que está sobre el límite, de modo que un marcador puesto en la línea de la valla se considera incluido.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/geo/point-in-polygon

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/geo/point-in-polygon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x":1,"y":1,"polygon":[{"x":0,"y":0},{"x":4,"y":0},{"x":4,"y":3},{"x":0,"y":3}]}'
{
  "x": 1,
  "y": 1,
  "polygon": [
    {
      "x": 0,
      "y": 0
    },
    {
      "x": 4,
      "y": 0
    },
    {
      "x": 4,
      "y": 3
    },
    {
      "x": 0,
      "y": 3
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.point_in_polygon",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Cómo funciona la prueba de ray casting par-impar

Los impactos en el contorno cortocircuitan a dentro con on_boundary verdadero para que los marcadores dibujados en la valla cuenten como contenidos. Todo el pipeline es aritmética de punto flotante determinista: sin semillas aleatorias, sin marcas de tiempo, sin llamadas de red y sin deriva de modelo, de modo que entradas idénticas siempre producen JSON idéntico. Los anillos degenerados con menos de tres vértices se rechazan con invalid_input en lugar de tratar en silencio un segmento como polígono.

Qué envía usted y qué recibe a cambio

Envíe el punto de prueba como campos numéricos obligatorios x e y, y el polígono como array obligatorio bajo el campo polygon con al menos tres vértices. Se admiten objetos point anidados opcionales para clientes que ya empaquetan la consulta como una sola estructura. Cuando el array polygon tiene longitud cero, uno o dos, la petición falla con un mensaje de que la prueba de punto en polígono necesita al menos tres vértices, para que quien llama pueda corregir la geometría en lugar de adivinar. Cada vértice puede ser un objeto con x e y o un array de dos números; también se aceptan los alias vertices y points para el anillo. Campos ausentes, cadenas no numéricas, NaN e Infinity fallan con invalid_input y no se cobran. Si tiene éxito, la respuesta incluye inside como booleano, on_boundary como booleano, un objeto point limpio, el array polygon limpio, n como recuento de vértices, crossings como el entero de cruces rayo-arista usado por la prueba de paridad, method fijado a ray_casting y rule a even_odd. Comprobaciones típicas de humo incluyen un cuadrado unitario con consulta en uno coma uno que está dentro, una consulta lejos fuera del cuadrado que está fuera, y un triángulo con un punto sobre un lado que está dentro con on_boundary verdadero. El precio de las llamadas API correctas es la base publicada de $0.002 por elemento; los fallos de validación no consumen saldo prepago.

Dónde aparecen las comprobaciones de punto en polígono en el trabajo real

Como esta capacidad es un motor de análisis puro, el precio de la API es la base publicada de $0.002 por elemento correcto y la validación fallida no consume saldo.

Geometría computacional en el aula

Demuestre ray casting, paridad y casos límite de contorno con JSON estable que incluye recuentos de cruces para verificación paso a paso.

¿Los puntos sobre la arista se cuentan como dentro?

Sí. Si la consulta cae sobre una arista o vértice dentro de una tolerancia numérica diminuta, inside es verdadero y on_boundary es verdadero.

Ver la documentación completa del KIT →