Geografía
Consulta la ubicación de inmuebles y aeropuertos en más de 600 000 zonas
Las API de Rapid Geography te permiten acceder a definiciones geográficas y asignaciones de propiedades de más de 600 000 regiones y aeropuertos. Incluye varias API secundarias que puedes aprovechar en tu implementación de Rapid API.
API de regiones
Si no estás seguro de qué ID de región concreta debes usar en tu búsqueda, utiliza la API de Regiones para encontrar la definición geográfica y las correspondencias 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 identificador de región de origen, esta API te mostrará todas las regiones de un continente, país u otro nivel concreto.
API de región
Si sabes el ID de la región que estás buscando, usa la API de regiones para obtener su definición geográfica y las asignaciones de propiedades correspondientes.
API de Polygon
Esta API te muestra los alojamientos que hay dentro de un polígono personalizado según tus definiciones geográficas. Úsalo para crear tu propia base de datos de correspondencias 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 « type » indica la entidad geográfica que representa, como una ciudad o un barrio. Consulta la lista de tipos de región para saber cuáles son las descripciones detalladas.
>> Mira la lista completa de tipos de regiones
Área
El parámetro « area » se puede usar para especificar un radio en kilómetros y, o bien, las coordenadas de latitud y longitud del centro, o bien los límites de una región.
- Al combinar el radio con
region_idse 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_interestcomo el únicotype, las regiones de tipopoint_of_interestno se incluirán en una solicitud que se filtre porarea. - Si se usa
point_of_interestjunto con otros tipos, se ignorarápoint_of_interest(sin errores) y se aplicarán todas las demás selecciones detype.
Ejemplos:
Búsqueda de aeropuertos en un radio de latitud o longitud de 50 km:
type=airport&limit=3&area=50,37.227924,93.310036Bú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=3Có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-MOLocalización
El objeto «language» solo utiliza pares con guion de los códigos de idioma y país de two-digit. 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.
>> Echa un vistazo a la lista de idiomas disponibles
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 que se representan con una sola coordenada (como un punto de interés, una estación de tren o un aeropuerto) no tienen un polígono delimitador.
El objeto bounding_polygon sigue el estándar GeoJSON, en el que, al proporcionar listas de coordenadas, el valor de la longitud aparece en primer lugar, seguido de la latitud.
>> Más información sobre el estándar GeoJSON
Nota: La API Rapid Lodging de admite una carga útil de 8 KB, lo que permite incluir 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.
- Los principales lugares de interés de una región determinada. Esto te permite recomendar sitios que visitar cuando un viajero va a 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: Muestra los niveles jerárquicos que están 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: Muestra los niveles jerárquicos que hay 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 obtener información más detallada sobre las características geográficas, visita tags y categories:
tags: Da más detalles sobre los elementos geográficos describiéndolos de forma que refleje cómo se llaman 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 elementos geográficos aplicable a nivel mundial y tienen como objetivo ofrecer niveles geográficos comparables, independientemente de la estructura de gobierno de cualquier país o región. Los ejemplos incluyen el continente, el país o la provincia.
Nota: Si tu implementación cuenta con varias fuentes de suministro, tendrás que organizarlas por capas en la zona geográfica que quieras utilizar.
Ejemplo:
"categories": [
"place:administrative",
"administrative:country"
],
"tags": [
"geo-admin:country"
]Asignaciones de los alojamientos a las regiones
Se proporcionan asignaciones de propiedades para distintos tipos de regiones, entre las que se incluyen high_level_region, province_state, multi_city_vicinity, city, neighborhood, point_of_interest y algunos países seleccionados. 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 regiones más grandes (high_level_region, province_state, country y continent), se mostrarán hasta las 500 propiedades principales. Para ver la lista completa de propiedades de estas regiones, tendrás que solicitar las propiedades de cada una de las subregiones que componen la región más amplia.
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.