Geografía

Las API de geografía te otorgan acceso a las definiciones geográficas y las asignaciones de los alojamientos de más de 600 000 regiones y aeropuertos.

Regiones

Devuelve la definición geográfica y las asignaciones de los alojamientos de las regiones que coinciden con los parámetros especificados.

Para solicitar todas la regiones, omite el parámetro de consulta del ancestro. Para solicitar todas las regiones de un continente, país u otro nivel determinado, indica el ID de esa región como el ancestro. Consulta la lista que aparece abajo con las regiones de nivel superior.

Región

Devuelve la definición geográfica y las asignaciones de los alojamientos del ID de la región solicitada.

Usa esta API para recuperar la información geográfica y las asignaciones de los alojamientos del ID de una región conocida.

Obtención de alojamientos dentro de una definición geográfica

Devuelve los alojamientos ubicados dentro de un polígono personalizado según tus definiciones geográficas.

Con esta API podrás ampliar la base de datos de las asignaciones de alojamientos si mantienes tus propias definiciones geográficas en vez de usar las regiones de Rapid. Asigna fácilmente los alojamientos a tus propias definiciones geográficas de zonas como áreas metropolitanas, ciudades y barrios.

Parámetros de búsqueda para filtrar

Tres parámetros de búsqueda permiten filtrar aún más los resultados para que los clientes encuentren resultados más precisos.

supply_source indica si los alojamientos están en Expedia o en Vrbo. Si no está incluido, este filtro se establecerá de forma predeterminada con supply_source=expedia.
country_code permite filtrar los resultados por país.
type explica la entidad geográfica representada, como una ciudad o un barrio.
country_subdivision_code permite filtrar por la subdivisión de países del ISO 3166-2.
area permite realizar búsquedas por geografía. Encuentra más información a continuación.

Información adicional de referencia

Tipos de región

El objeto type explica la entidad geográfica representada, por ejemplo, una ciudad o un barrio. Consulta la lista de tipos de región para saber cuáles son las descripciones detalladas.

Área

El objeto area puede utilizarse junto con un radio kilométrico y unas coordenadas centrales de latitud o longitud o la frontera 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_score=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 language solamente utiliza pares de códigos de dos dígitos del idioma y del país unidos por un guion. Consulta todas las opciones de idioma aquí. 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 única coordenada (por ejemplo, un lugar de interés, una estación ferroviaria, un aeropuerto...) no tienen un polígono delimitador.

El objeto bounding_polygon cumple el estándar GeoJSON con el valor de la longitud mencionado en primer lugar, seguido del valor de la latitud cuando se proporcionan listas de 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.
Puntos de interés (POI) principales de una región determinada. Esto te permite recomendar un POI que los viajeros pueden visitar mientras están de paso por 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 representan los niveles jerárquicos situados 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 representan los niveles jerárquicos situados 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.

tags y categories permiten que los colaboradores puedan informar a los clientes de una forma más detallada sobre las características geográficas.

tags proporcionan un mayor nivel de detalle sobre las características geográficas al describirlas de una manera que refleje cómo se las nombran 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 características geográficas aplicable a escala internacional y su objetivo es ofrecer niveles geográficos comparables independientemente de la estructura gubernamental en cualquier país o región determinada. Los ejemplos incluyen el continente, el país o la provincia.

Nota: Los colaboradores con inventario procedente de diversas fuentes deberán distribuir su inventario en el área geográfica que quieran usar.

Ejemplo:

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

Asignaciones de los alojamientos a las regiones

Se proporcionan asignaciones de los alojamientos para la región y la API de regiones. Los tipos de región con asignaciones de los alojamientos son high_level_region, state_province, multi_city_vicinity, city, neighborhood, point_of_interest y determinados países. 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.

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.