YapQ Geosearch

GET

YapQ Geosearch

Amadeus has partnered with YapQ to bring you point of interest APIs with the goal of offering you unbiased ratings of landmarks and tourist attractions. YapQ rates places according to their interest on social media and provides Wikipedia content and Geonames ID at a given location.
YapQ's service indexes millions of points around the world, and provides content in 12 different languages. This allows you to ensure you catch the must-see sights at a specific YapQ supported location.
Each point of interest comes with links to content, grading information, location and directions to help make discovering your destination easy and fun.

This service is still under active development, and the response format may change without warning. We'd be interested in your feedback - send us an email.

Resource URL

https://api.sandbox.amadeus.com/v1.2 /points-of-interest/yapq-search-circle

Query Parameters


Name Values Description
apikey
(required)

API Key provided for your account, to identify you for API access. Make sure to keep this API key secret.

latitude
(required)

Latitude of the center of the search, in decimal degrees

longitude
(required)

Longitude of the center of the search, in decimal degrees

radius
(required)

Radius around the center to look for points-of-interest around the given latitude and longitude in kilometers (km)

lang

The preferred language of the content related to each point of interest. Content will be returned in this language if available

category

Filters the resulting points_of_interest to include only results which have a least one category containing the given provided word. Good examples are museum, landmark or church

geonames

Setting this to true includes only points of interest with a geonames ID

vibes

Includes content that doesn't correspond to an active physical place, but which gives the user some background information, or vibe for the place they are visiting. An example of this may be information on an influential demolished building that used to exist at a certain location, or more information on a district of the city

social_media

Enabling this includes images from Instagram in the output results. This is disabled by default, since these images are often just pictures of people or food, which often have little relevance to the actual location

image_size

The size of the images you'd like to see in the response

number_of_images

Number of images to display.

number_of_results

The maximum number of points of interest to return in the results set. This is a range from 1 to 100


Request Body

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Working...

 

PointsOfInterestResponse

  • current_city : PointOfInterestCity
  • points_of_interest : List

PointOfInterestCity

  • name : String
    The name of the location that was searched for
  • geoname_id : String
    The Geonames ID of the location that was searched for
  • location : Geolocation
  • total_points_of_interest : Integer
    The total number of points_of_interest that YapQ has indexed for this city

PointOfInterestResult

  • title : String
    Display name of a given point of interest
  • main_image : String
    A link to an image of the given location
  • location : Geolocation
  • grades : PointOfInterestResult_grades
  • categories : List
    Array of descriptions indicating what type of point of interest this is. You can filter the results to include only certain categories of point of interest using the category input parameter.
  • details : PointOfInterestDetails
  • contextual_images : List
    Images taken at this point of interest. Note that these images might have nothing to do with the point itself, particularly if you have enabled the social_media parameter
  • geoname_id : Integer
    The GeonamesID of this point of interest, if available
  • walk_time : Number
    Time in minutes that it takes to get from the searched coordinates to this Point of Interest

PointOfInterestDetails

  • short_description : String
    A summary of the given point
  • description : String
    A paragraph describing this point of interest
  • wiki_page_link : String
    A link to this point of interest's wikipedia page

PointOfInterestResult_grades

  • yapq_grade : Integer
    Main YAPQ grade. A grade out of 5 for this point, rated against all points in the world and normalized among selected group of points. 5 is best, 0 is worst.
  • city_grade : Integer
    The ranking of this point of interest compared to other points in this city. 1 is the highest rated.

Geolocation

  • latitude : BigDecimal
    The north-south coordinate of this location, in decimal degrees, between -90 and 90
  • longitude : BigDecimal
    The east-west coordinate of this location, in decimal degrees, between -180 and 180
  • google_maps_link : String
    For YapQ APIs only - a link to a google map rendering of this location.

ImageSize

  • small : Image
  • medium : Image
  • large : Image
  • hd : Image

Image

  • category : String
    The enumerated category of this image type. Common values include EXTERIOR, GUEST_ROOM, SUITE, LOBBY, RESTAURANT, LOUNGE, LOGO, MAP, MISC and UNKNOWN.
  • width : Integer
    The pixel width of the image at the provided URL.
  • height : Integer
    The pixel height of the image at the provided URL.
  • url : String
    The URL of the hotel image of this given category and size, for display.
 

Example - YapQ GeoSearch Search

Example of an error, searching for a geolocation without specifying a radius

https://api.sandbox.amadeus.com/v1.2/points-of-interest/yapq-search-circle?latitude=41.878&longitude=-87.645&apikey=<YOUR_API_KEY_HERE>

gives a HTTP 400 response with an error like this

{ 
  "status" : 400,
  "message" : "Radius parameter required",
  "more_info" : "You need to provide a radius parameter in kilometers between 0.1 and 200. For example, a value of 5 will search for Points of Interest within 5km of the coordinates or center of the city you specified"
}

Search all points of interest within 1 km of Chicago (latitude=41.878&longitude=-87.645)

https://api.sandbox.amadeus.com/v1.2/points-of-interest/yapq-search-circle?latitude=41.878&longitude=-87.645&radius=1&apikey=<YOUR_API_KEY_HERE>

gives a response like this

{
    "points_of_interest": [
        {
            "main_image": "https://upload.wikimedia.org/wikipedia/commons/thumb/8/83/Willis_Tower_night_2.jpg/317px-Willis_Tower_night_2.jpg",
            "title": "Willis Tower",
            "contextual_images": [
                {
                    "medium": {
                        "url": "https://drscdn.500px.org/photo/46341470/w%3D600_h%3D600/7650f4ec548a57f320acfb4dc547d54a?v=0",
                        "width": "600",
                        "height": "600"
                    }
                },
                {
                    "medium": {
                        "url": "https://drscdn.500px.org/photo/106629511/w%3D600_h%3D600/08ca291a0dd503932ea6d861fec944dd?v=10",
                        "width": "600",
                        "height": "600"
                    }
                },
                {
                    "medium": {
                        "url": "https://drscdn.500px.org/photo/41774388/w%3D600_h%3D600/4cd16435ae6c065fdc8e10f8e6198658?v=0",
                        "width": "600",
                        "height": "600"
                    }
                },
                {
                    "medium": {
                        "url": "https://drscdn.500px.org/photo/41774390/w%3D600_h%3D600/45fd6de98965625057ff3ba1610271cf?v=0",
                        "width": "600",
                        "height": "600"
                    }
                }
            ],
            "geoname_id": 4910967,
            "grades": {
                "yapq_grade": 4.52,
                "city_grade": 7
            },
            "details": {
                "short_description": "The Willis Tower, built as and still commonly referred to as Sears Tower, is a 108-story, 1,451-foot  skyscraper in Chicago, Illinois, United States.",
                "description": "The Willis Tower, built as and still commonly referred to as Sears Tower, is a 108-story, 1,451-foot  skyscraper in Chicago, Illinois, United States. At completion in 1973, it surpassed the World Trade Center towers in New York to become the tallest building in the world, a title it held for nearly 25 years. The Willis Tower is the second-tallest building in the United States and the 12th-tallest in the world. More than one million people visit its observation deck each year, making it one of Chicago's most popular tourist destinations. The structure was renamed in 2009 by the Willis Group as part of its lease on a portion of the tower's space.\nAs of December 2013, the building's largest tenant is United Airlines, which moved its corporate headquarters from the United Building at 77 West Wacker Drive in 2012 and today occupies around 20 floors with its headquarters and operations center.\nThe building's official address is 233 South Wacker Drive, Chicago, Illinois 60606.",
                "wiki_page_link": "https://en.wikipedia.org/wiki/Willis Tower"
            },
            "categories": [
                "1973 establishments in Illinois",
                "Airline company headquarters in the United States",
                "Buildings and structures on U.S. Route 66",
                "Central Chicago",
                "Former world's tallest buildings",
                "Landmarks in Chicago, Illinois",
                "Office buildings completed in 1973",
                "Office buildings in Chicago, Illinois",
                "Retail company headquarters in the United States",
                "Skidmore, Owings & Merrill buildings",
                "Skyscrapers in Chicago, Illinois",
                "Skyscrapers over 350 meters",
                "United Airlines",
                "Visitor attractions along U.S. Route 66",
                "Visitor attractions in Chicago, Illinois"
            ],
            "location": {
                "latitude": 41.8789,
                "google_maps_link": "http://maps.google.com?q=41.8789,-87.6358",
                "longitude": -87.6358
            }
        },
        {
            "main_image": "https://upload.wikimedia.org/wikipedia/commons/thumb/b/be/NAVTEQ_car.JPG/400px-NAVTEQ_car.JPG",
            "title": "Navteq",
            "contextual_images": [
                {
                    "medium": {
                        "url": "https://scontent.cdninstagram.com/t51.2885-15/s320x320/e35/12751185_1696031947347089_1574537496_n.jpg?ig_cache_key=MTE4NjU0Njc4NTc0MzQzOTA1Mw%3D%3D.2.l",
                        "width": "320",
                        "height": "320"
                    }
                },
                {
                    "medium": {
                        "url": "https://scontent.cdninstagram.com/t51.2885-15/s320x320/e35/12716587_951429824948950_1244539729_n.jpg?ig_cache_key=MTE4NjM4MzgxOTM5MzU1NzEwOQ%3D%3D.2",
                        "width": "320",
                        "height": "320"
                    }
                },
                {
                    "medium": {
                        "url": "https://scontent.cdninstagram.com/t51.2885-15/s320x320/e35/12628138_860209117420910_925330531_n.jpg?ig_cache_key=MTE4NjM4MjE3NDc0ODIzODQwNw%3D%3D.2",
                        "width": "320",
                        "height": "320"
                    }
                },
                {
                    "medium": {
                        "url": "https://scontent.cdninstagram.com/t51.2885-15/s320x320/e35/12747649_1039520399425185_55711552_n.jpg?ig_cache_key=MTE4NjM3ODI1MjM2MDY3MzM5OQ%3D%3D.2.l",
                        "width": "320",
                        "height": "320"
                    }
                }
            ],
            "geoname_id": 0,
            "grades": {
                "yapq_grade": 4.31,
                "city_grade": 42
            },
            "details": {
                "short_description": "NAVTEQ was an American Chicago-based provider of Geographic Information Systems  data and a major provider of base electronic navigable maps.",
                "description": "NAVTEQ was an American Chicago-based provider of Geographic Information Systems  data and a major provider of base electronic navigable maps. The company was acquired by Nokia in 2007/2008, and fully merged into Nokia in 2011 to form part of the HERE business unit.",
                "wiki_page_link": "https://en.wikipedia.org/wiki/Navteq"
            },
            "categories": [
                "Defunct companies based in Chicago, Illinois",
                "GIS companies",
                "Map companies of the United States",
                "Nokia assets"
            ],
            "location": {
                "latitude": 41.8844,
                "google_maps_link": "http://maps.google.com?q=41.8844,-87.6392",
                "longitude": -87.6392
            }
        },
}