Geografía

Accede a la localización de inmuebles y aeropuertos en más de 600.000 regiones

Las API de Rapid Geography te proporcionan acceso a definiciones geográficas y mapeados de propiedades de más de 600.000 regiones y aeropuertos. Incluye múltiples API hijas para que las aproveches en tu implementación de Rapid API.

API de regiones

Si no estás seguro de un ID de región concreto para utilizarlo en tu búsqueda, utiliza la API de Regiones para encontrar la definición geográfica y las asignaciones de propiedades de las regiones que coincidan con los parámetros solicitados. Para solicitar todas la regiones, omite el parámetro de consulta del ancestro. Si incluyes un ID de región antecesora, esta API te devolverá todas las regiones de un continente, país u otro nivel concreto.

API de región

Si conoces el ID de la región que buscas, utiliza la API de región para obtener la definición geográfica y las asignaciones de propiedades correspondientes.

API de polígonos

Esta API devuelve las propiedades dentro de un polígono personalizado basándose en tus definiciones geográficas. Utilízalo para crear tu base de datos de mapas de propiedades si mantienes tus propias definiciones geográficas y no utilizas las regiones geográficas de Rapid API. Asigna fácilmente los alojamientos a tus propias definiciones geográficas de zonas como áreas metropolitanas, ciudades y barrios.

Información adicional de referencia

Tipos de región

El campo typeexplica la entidad geográfica representada, como ciudad o barrio. Consulta la lista de tipos de región para saber cuáles son las descripciones detalladas.

Área

El parámetro areapuede utilizarse para especificar un radio kilométrico y las coordenadas de latitud/longitud central o el límite de una región.

Al combinar el radio con region_id se buscará un área que extenderá el número de kilómetros indicado en todas las direcciones desde los límites de la región.
Si se combina el radio con un único punto, especificado por un par de latitud y longitud, se buscará un área dentro del radio especificado.
El radio debe indicarse en kilómetros enteros no negativos. Si se usan decimales, se producirá un error. Se permite un radio de 0.

Restricciones

Al indicar el parámetro del área, se mostrarán 100 resultados como máximo. Pueden reducirse aún más con el parámetro de límite.
Debido al número de resultados, a menos que se indique point_of_interest como el único type, las regiones de tipo point_of_interest no se incluirán en una solicitud que se filtre por area.
Si se usa point_of_interest junto con otros tipos, se ignorará point_of_interest (sin errores) y se aplicarán todas las demás selecciones de type.

Ejemplos:

Búsqueda de aeropuertos en un radio de latitud o longitud de 50 km:

type=airport&limit=3&area=50,37.227924,93.310036

Búsqueda en el área del ID de región para el type ciudad con un límite de 3 y un área de 5 km:

&area=5,602962&supply_source=expedia&type=city&limit=3

Código de subdivisión del país

Filtra los resultados exclusivamente por la subdivisión de países del ISO 3166-2, como US-MO.country_subdivision_code es un campo y un parámetro de búsqueda.

Ejemplo:

Búsqueda de región por código ISO:

country_subdivision_code =US-MO

Localización

El objeto languagesólo utiliza pares de códigos de idioma y país con guión two-digit, consulta la lista de opciones de idioma disponibles. Antes de integrar los códigos, repasa nuestra sección de idiomas aceptados. Solamente los campos name y name_full de las respuestas se facilitan en el idioma solicitado. Las demás definiciones geográficas de la respuesta aparecerán en inglés.

Polígonos

El objeto bounding_polygon proporciona la lista de coordenadas que delimitan la región. Las regiones pueden abarcar áreas representadas por un único polígono o por varios. Los tipos de región representados por una sola coordenada (como punto de interés, estación de tren o aeropuerto) no tienen polígono delimitador.

El objeto bounding_polygonsigue aEstándar GeoJSON indicando en primer lugar el valor de la longitud, seguido de la latitud, al proporcionar listas de coordenadas.

Nota: Rapid Lodging API admite una carga útil de 8 KB, que puede alojar hasta 2.000 coordenadas.

Asociaciones entre regiones

El vínculo turístico entre regiones se proporciona mediante el objeto de associations. Dentro del objeto associations, modelizamos:

La ciudad asociada a regiones del tipo aeropuerto. Esto te permite recomendar un destino para cualquier aeropuerto en particular.
Principales puntos de interés de una región determinada. Esto te permite recomendar lugares que visitar cuando un viajero visita una región concreta, como California, Londres o Brooklyn.

Jerarquía entre regiones

La relación entre regiones se proporciona mediante los objetos ancestors y descendants. A causa de las variaciones geográficas y políticas existentes en todo el mundo, los tipos de región no cuentan con una jerarquía estricta. Sin embargo, una ciudad se suele asociar con un área metropolitana, una provincia, un estado o un país. Para obtener la jerarquía de una región, usa los valores ancestors.

ancestors: Representa los niveles de jerarquía por encima de una región determinada. Así, el ancestro directo del área metropolitana de Atenas es la región de Ática y, más arriba de la jerarquía, se incluyen Grecia y Europa. Una región puede tener más de un progenitor. Así, como el área metropolitana de Ginebra cubre la frontera entre Suiza y Francia, tendrá ancestros en ambos países.
descendants: Representa los niveles de jerarquía por debajo de una región determinada. En nuestro ejemplo, la ciudad de El Pireo, Grecia, es un descendiente del área metropolitana de Atenas, Grecia. El mapa de descendientes dentro de un objeto de región solamente contiene los elementos secundarios directos (un nivel más abajo) de esa región.

Para proporcionar información más detallada sobre los accidentes geográficos, utiliza tagsy categories:

tags: Proporcionar más detalles granulares en torno a los accidentes geográficos describiéndolos de forma que reflejen cómo se nombran esos accidentes en la vida real. Los ejemplos incluyen descripciones de actividades (esquí, hipódromo, etc.), atracciones, áreas cívicas o áreas geográficas administrativas como un cantón, una parroquia o un distrito.
categories: Crean una jerarquía de accidentes geográficos aplicable a nivel mundial y pretenden ofrecer niveles geográficos comparables independientemente de la estructura gubernamental de un país o región determinados. Los ejemplos incluyen el continente, el país o la provincia.

Nota: Si tu aplicación tiene varias fuentes de suministro, tendrás que estratificarlas en la geografía que quieras utilizar.

Ejemplo:

"categories": [
"place:administrative",
"administrative:country"
],
"tags": [
"geo-admin:country"
]

Asignaciones de los alojamientos a las regiones

Se proporcionan mapeos de propiedades para tipos de regiones, incluyendo high_level_region, province_state, multi_city_vicinity, city, neighborhood, point_of_interest, y países selectos. Las asignaciones de los alojamientos están disponibles en dos opciones del parámetro include:

property_ids: esta opción incluye solamente alojamientos incluidos en el polígono de la región. El polígono es la forma delimitadora que representa el área de la región.
property_ids_expanded: si el polígono de la región no contiene al menos 100 alojamientos, esta opción mostrará los alojamientos incluidos en el polígono y, además, los situados dentro de un radio de 30 km de la región. Este conjunto ampliado de alojamientos debe servir para que se muestren suficientes en los resultados de búsqueda del destino. Para los tipos de región representados por una única coordenada en vez de por un polígono (por ejemplo, un lugar de interés), solamente esta opción ampliada proporcionará asignaciones asociadas a los alojamientos.

Para los tipos de región más grandes (high_level_region, province_state, country, y continent), se devolverán hasta las 500 propiedades principales. Para obtener una lista completa de los alojamientos de estas regiones, tendrás que solicitar propiedades a cada uno de los descendientes que componen la región mayor.

Los polígonos están optimizados para utilizar datos de búsquedas y transacciones, y ampliarán las regiones más pequeñas fuera del polígono donde sea más relevante.

Detalles de la API

Explora las definiciones de los puntos de conexión relacionados con la geografía en esta página y usa API Explorer u otro software de pruebas para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.

Recursos adicionales

Tanto si lo que quieres es probar todos los puntos de conexión de Rapid API como si quieres descargar las especificaciones de OpenAPI o nuestra colección de Postman, tenemos lo que necesitas.