Your EPS account
Sign in to view secure API documentation, update your account details, log support requests and much more.
Your email or password is incorrect. Please try again or reset your password.
If the issue persists please contact your EPS representative.
Reset your password
Please enter your email address below. We will send password reset instructions to the email associated with your EPS account.
Thank you
An email has been sent to your account email address with further instructions on how to reset your password.
Geography
The Geography APIs provide you with access to geographic definitions and property mappings for over 600,000 regions and airports.
Regions
Returns the geographic definition and property mappings of regions matching the specified parameters.
To request all regions in the world, omit the ancestor query parameter. To request all regions in a specific continent, country or other level, specify the ID of that region as the ancestor. Refer to the list of top level regions.
Region
Returns the geographic definition and property mappings for the requested Region ID.
Use this API to retrieve geography information and property mappings for a known Region ID.
Get Properties within Geography Definition
Returns the EPS properties within a custom polygon based on your geography definitions.
Use this API to build out your property mapping database if you maintain your own geography definitions and do not use the EPS geography regions. Easily map properties to your geography definitions for areas such as multi-cities, cities and neighborhoods.
Additional Reference Information
REGION TYPES
The type object explains the geographic entity represented such as city or neighborhood. Refer to the list of region types for detailed descriptions.
LOCALIZATION
The language
object only uses hyphenated pairs of two-digit language and country codes - see parameter entry for details. Review our supported languages before integrating any codes. Only the name
and name_full
fields in the responses are provided in the requested language. All other geography definitions in the response will be in English.
POLYGONS
The bounding_polygon
object provides the list of coordinates that encompass the shape of the region. Regions can cover areas represented by either a single polygon or multiple polygons. Region types that are represented by a single coordinate (e.g. point of interest, train station, airport, etc.) do not have a bounding polygon. The bounding_polygon
object follows the GeoJSON standard with the longitude value listed first followed by latitude when providing lists of coordinates.
ASSOCIATIONS BETWEEN REGIONS
The touristic relationship between Regions is provided using the associations object. Within the associations object, we model:
- Associated city for Regions of type airport. This allows you to recommend a destination for any particular airport.
- Top POI for a given Region. This allows you to recommend POI to visit when a traveler is visiting a particular Region, such as California, London or Brooklyn.
HIERARCHY BETWEEN REGIONS
The relationship between regions is provided using the ancestors
and descendants
objects. Due to geographical and political variations throughout the world, region types do not have a strict hierarchy. Logically, however, a city is typically associated with a multi-city, province/state or country. To derive the hierarchy of a specific region, use the ancestors
values.
ancestors
represent the levels of hierarchy above a given region. For example, the direct ancestor of the multi-city of Athens, Greece is the region of Attica and further up the hierarchy its ancestors include Greece and Europe. A region may have more than one parent. Since the multi-city of Geneva is on the border of Switzerland and France, it will have ancestors in both countries.descendants
represent the levels of hierarchy below a given region. In our example, the city of Piraeus, Greece is a descendant of the multi-city of Athens, Greece. The descendants map within a region object only contains the direct children (one level down) of that region.
PROPERTY MAPPINGS FOR REGIONS
Property mappings are provided for the Region and Regions API. Region types with property mappings are: high_level_region, state_province, multi_city_vicinity, city, neighborhood, point_of_interest, and select countries. Property mappings are available in two include
parameter options:
property_ids
: This option provides only the properties within the region's polygon. The polygon is the bounding shape that represents the region’s area.property_ids_expanded
: If the region’s polygon does not contain at least 100 properties, this option provides the properties within the polygon in addition to properties within a 30km radius of the region. This expanded set of properties should ensure that enough properties are presented in property search results for a destination. For region types represented by a single coordinate rather than a polygon (e.g. point of interest), only this expanded option will provide associated property mappings.
Polygons are optimized to use search and transaction data and will expand smaller regions outside of the polygon where most relevant.
DATABASE RECOMMENDATIONS
See the geography database recommendations for guidelines on setting up your content database.
Download the Swagger full description containing all APIs
Download the EPS Rapid 2.4 Postman collection
See the changes that we've made here.
EPS Home | EPS Portal Login | Expedia Partner Central | Advertise with Expedia | News | Privacy Policy | Cookie Policy
© 2022 Expedia, Inc. All Rights Reserved.