/map-geos

Return all the geographic locations near the specified Lat/Long or location sorted by distance.

Request

http://api.tripadvisor.com/api/partner/2.0/map/42.33141,-71.099396/geos?key=PARTNER_KEY

Query Parameters

Name Description
lang The desired language locale. 
currency currency code to use for request and response (should follow ISO 4217).
category When the location is a country, specify category-city to specifically list all cities in the country. When category=city, sort order matches the site for this country/region.
offset Distance from the starting point of the list.
lunit Length unit (either 'mi' or 'km') which overrides the default length units used in input and output.
distance Distance in miles (unless another unit is specified using lunit) defining the width and height of the bounding rectangle around the center when specified. Defaults to 10 miles. The maximum is 25 miles or 50 kilometers.

Response

{
  "data": [
    {
      "see_all_photos": "http://www.tripadvisor.com/LocationPhotos-g28942-d60823-m11068-Brookline-Massachusetts.html",
      "abbrv": null,
      "web_url": "http://www.tripadvisor.com/Tourism-g60823-m11068-Brookline_Massachusetts-Vacations.html",
      "photo": {
        "published_date": "2009-09-24T22:40:49-0400",
        "id": "21579070",
        "is_blessed": true,
        "images": {
          "thumbnail": {
            "height": "50",
            "width": "50",
            "url": "http://media-cdn.tripadvisor.com/media/photo-t/01/49/45/3e/parque-que-rodea-el-tramo.jpg"
          },
          "original": {
            "height": "2592",
            "width": "3456",
            "url": "http://media-cdn.tripadvisor.com/media/photo-o/01/49/45/3e/parque-que-rodea-el-tramo.jpg"
          },
          "small": {
            "height": "150",
            "width": "150",
            "url": "http://media-cdn.tripadvisor.com/media/photo-l/01/49/45/3e/parque-que-rodea-el-tramo.jpg"
          },
          "large": {
            "height": "412",
            "width": "550",
            "url": "http://media-cdn.tripadvisor.com/media/photo-s/01/49/45/3e/parque-que-rodea-el-tramo.jpg"
          },
          "medium": {
            "height": "187",
            "width": "250",
            "url": "http://media-cdn.tripadvisor.com/media/photo-f/01/49/45/3e/parque-que-rodea-el-tramo.jpg"
          }
        },
        "caption": "parque que rodea el tramo del tren de cercanías que va de Longwood a Brookline Village",
        "user": null
      },
      "location_string": "Brookline, Massachusetts",
      "location_id": "60823",
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/60823?key=PARTNER_KEY",
      "address_obj": {
        "street1": null,
        "street2": null,
        "city": null,
        "state": "Massachusetts",
        "country": "United States",
        "postalcode": null,
        "address_string": "Brookline, MA"
      },
      "partner_location_id": [],
      "distance": ".82",
      "category": {
        "name": "geographic",
        "localized_name": "Geographic"
      },
      "awards": [],
      "geo_type": "narrow",
      "description": null,
      "subcategory": [
        {
          "name": "city",
          "localized_name": "City"
        }
      ],
      "name": "Brookline",
      "ancestors": [
        {
          "abbrv": "MA",
          "level": "State",
          "name": "Massachusetts",
          "location_id": "28942"
        },
        {
          "abbrv": null,
          "level": "Country",
          "name": "United States",
          "location_id": "191"
        }
      ],
      "bearing": "west",
      "longitude": "-71.11453",
      "latitude": "42.33523"
    },
    {
      "see_all_photos": "http://www.tripadvisor.com/LocationPhotos-g28942-d60745-m11068-Boston-Massachusetts.html",
      "abbrv": null,
      "web_url": "http://www.tripadvisor.com/Tourism-g60745-m11068-Boston_Massachusetts-Vacations.html",
      "photo": {
        "published_date": "2009-11-17T08:56:07-0500",
        "id": "22588325",
        "is_blessed": true,
        "images": {
          "thumbnail": {
            "height": "50",
            "width": "50",
            "url": "http://media-cdn.tripadvisor.com/media/photo-t/01/58/ab/a5/the-view.jpg"
          },
          "original": {
            "height": "3000",
            "width": "4000",
            "url": "http://media-cdn.tripadvisor.com/media/photo-o/01/58/ab/a5/the-view.jpg"
          },
          "small": {
            "height": "150",
            "width": "150",
            "url": "http://media-cdn.tripadvisor.com/media/photo-l/01/58/ab/a5/the-view.jpg"
          },
          "large": {
            "height": "412",
            "width": "550",
            "url": "http://media-cdn.tripadvisor.com/media/photo-s/01/58/ab/a5/the-view.jpg"
          },
          "medium": {
            "height": "187",
            "width": "250",
            "url": "http://media-cdn.tripadvisor.com/media/photo-f/01/58/ab/a5/the-view.jpg"
          }
        },
        "caption": "The view",
        "user": null
      },
      "location_string": "Boston, Massachusetts",
      "location_id": "60745",
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/60745?key=PARTNER_KEY",
      "address_obj": {
        "street1": null,
        "street2": null,
        "city": null,
        "state": "Massachusetts",
        "country": "United States",
        "postalcode": null,
        "address_string": "Boston, MA"
      },
      "partner_location_id": [
        "c60745"
      ],
      "distance": "2.76",
      "category": {
        "name": "geographic",
        "localized_name": "Geographic"
      },
      "awards": [
        {
          "award_type": "Traveler's Choice",
          "year": "2014",
          "images": {
            "small": "http://www.tripadvisor.com/img/cdsi/img2/awards/tchotel_2014_L_TM-11068-5.png",
            "large": "http://www.tripadvisor.com/img2/awards/TC_2014_downloadable_L_R.jpg"
          },
          "categories": [
            "Destinations"
          ],
          "display_name": "Traveler's Choice"
        }
      ],
      "geo_type": "narrow",
      "description": "No, you can’t actually park your car in Harvard Yard. What you can do in Boston is enjoy some of the country’s most important historical sites and impassioned sports fans. Catch a game at Fenway Park before heading to the North End for some of the Italian neighborhood’s legendary cannoli. Take in the gilded glory of the State House from the edge of the Boston Common, also the starting point for the Freedom Trail, a walking route between 16 sites that were integral to the American Revolution.  ",
      "subcategory": [
        {
          "name": "city",
          "localized_name": "City"
        }
      ],
      "name": "Boston",
      "ancestors": [
        {
          "abbrv": "MA",
          "level": "State",
          "name": "Massachusetts",
          "location_id": "28942"
        },
        {
          "abbrv": null,
          "level": "Country",
          "name": "United States",
          "location_id": "191"
        }
      ],
      "bearing": "northeast",
      "longitude": "-71.05834",
      "latitude": "42.357277"
    },
    {
      "see_all_photos": "http://www.tripadvisor.com/LocationPhotos-g28942-d60890-m11068-Cambridge-Massachusetts.html",
      "abbrv": null,
      "web_url": "http://www.tripadvisor.com/Tourism-g60890-m11068-Cambridge_Massachusetts-Vacations.html",
      "photo": {
        "published_date": "2010-09-02T13:25:13-0400",
        "id": "27362789",
        "is_blessed": false,
        "images": {
          "thumbnail": {
            "height": "50",
            "width": "50",
            "url": "http://media-cdn.tripadvisor.com/media/photo-t/01/a1/85/e5/longfellow-bridge.jpg"
          },
          "original": {
            "height": "0",
            "width": "0",
            "url": null
          },
          "small": {
            "height": "150",
            "width": "150",
            "url": "http://media-cdn.tripadvisor.com/media/photo-l/01/a1/85/e5/longfellow-bridge.jpg"
          },
          "large": {
            "height": "363",
            "width": "550",
            "url": "http://media-cdn.tripadvisor.com/media/photo-s/01/a1/85/e5/longfellow-bridge.jpg"
          },
          "medium": {
            "height": "165",
            "width": "250",
            "url": "http://media-cdn.tripadvisor.com/media/photo-f/01/a1/85/e5/longfellow-bridge.jpg"
          }
        },
        "caption": "Longfellow Bridge",
        "user": null
      },
      "location_string": "Cambridge, Massachusetts",
      "location_id": "60890",
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/60890?key=PARTNER_KEY",
      "address_obj": {
        "street1": null,
        "street2": null,
        "city": null,
        "state": "Massachusetts",
        "country": "United States",
        "postalcode": null,
        "address_string": "Cambridge, MA"
      },
      "partner_location_id": [],
      "distance": "3.00",
      "category": {
        "name": "geographic",
        "localized_name": "Geographic"
      },
      "awards": [],
      "geo_type": "narrow",
      "description": "Home to two of America's most prestigious universities, Cambridge exudes a certain intellectual quirkiness. A mix of historical haunts, student hang-outs, alternative art and culture venues, vintage clothing shops, bookstores and ethnic restaurants, the city is, well, really cool.  Although it is located just across the Charles River from Boston, Cambridge has a distinct vibe that is noticeable immediately. Start at Harvard Square, a hub of activity and mishmash of trendy stores, outdoor cafes and colorful local characters. Pick up a walking tour map at the visitors information booth in the center of the Square. The route will take you past many important landmarks including the Mount Auburn Cemetery, Tory Row and the Longfellow National Historic Site. Harvard University offers student-led tours through the illustrious buildings and monuments of its sprawling campus.  Art and architecture buffs should meander around the M.I.T campus, which includes outdoor sculptures by masters such as Picasso and 20th-century buildings designed by modern greats like Eero Saarinen and I. M. Pei.  Along the way, browse through bookstores, stop to watch street performers and grab a coffee at an outdoor café to take in all this captivating city has to offer.",
      "subcategory": [
        {
          "name": "city",
          "localized_name": "City"
        }
      ],
      "name": "Cambridge",
      "ancestors": [
        {
          "abbrv": "MA",
          "level": "State",
          "name": "Massachusetts",
          "location_id": "28942"
        },
        {
          "abbrv": null,
          "level": "Country",
          "name": "United States",
          "location_id": "191"
        }
      ],
      "bearing": "north",
      "longitude": "-71.11766",
      "latitude": "42.372635"
    }
  ],
  "paging": {
    "previous": null,
    "skipped": "0",
    "results": "3",
    "next": "http://api.tripadvisor.com/api/partner/2.0/map/42.33141,-71.099396/geos?limit=3&offset=3&key=PARTNER_KEY",
    "total_results": "53"
  }
}

Properties

Name Type Description
location_id number Unique Tripadvisor location ID of the destination or POI.
name string Name of the POI as listed on Tripadvisor.
rating number

Overall rating for this POI. Not applicable to geographic locations. Rating levels are defined as follows:


5

Excellent

4

Very good

3

Average

2

Poor

1

Terrible
rating_image_url URL URL to the bubble rating image for this location. As noted in the Display Guidelines, overall Bubble Ratings must be displayed using the Tripadvisor bubble rating image with the owl icon.
num_reviews number Count of total reviews published for this location.
percent_recommended number

Deprecated - will be displayed as null.

The percent of reviewers who recommend this location (rated 4/5 or higher). May not be present if there are are not enough reviews to calculate a percentage.
description string Plaintext description of this location.
location_string string Destination location for the POI. Most commonly written as city, state or city, province/region. In cases where state/province/region is not relevant, then it would be city, country. This string is localized if a language other than English is requested.
category object Type of location this is: geographic, hotel, restaurant, attraction. For now, both key and name are the same.
subcategory object Detailed type of this location.
trip_types object Object with counts of review for this location for each trip type (business, couples, family, friends, solo).
awards object Returns a list of all of the awards for this location, which includes Certificate of Excellence, Travelers' Choice, and Green Leader. For each award, a small and large image will be returned as well.
latitude number The latitude of this location in degrees. Null if unavailable.
longitude number The longitude of this location in degrees. Null if unavailable.
geo_type string The tourism classification for geographic locations. Can be 'broad', 'hybrid', or 'narrow'.
price_level string Range of prices per night for a hotel OR range of prices per meal for a restaurant. Returned in the currency specified as an option. Price ranges include all taxes and fees whenever possible. This field is only applicable for location type: restaurant, hotel.
category_counts number The number of attractions inside of a geographic location. This field is only applicable for location type: geographic. It is not available at the state/province/country level.
web_url URL URL to this location on the Tripadvisor site.
ancestors object List of geographic entities that contain this location.
address_obj object Object containing address data for this location.
wikipedia_info object Object containing Wikipedia links for attractions.
photo_count number Number of Tripadvisor photos for this location.
abbrv string Abbreviated form of the location name if one exists (MA for Massachusetts, for example).
see_all_photos URL URL to Tripadvisor photos page for this location.
see_all_hotels URL URL to Tripadvisor hotels page for this location.
see_all_attractions URL URL to Tripadvisor attractions page for this location.
see_all_restaurants URL URL to Tripadvisor restaurants page for this location.
api_detail_url URL Link to the API url that shows details about one individual location in the list.
paging object Information required to browse the next and previous sets of locations in the list, if they were not all returned as part of the current call.
distance number This field applies only for calls that pass in a Latitude and Longitude as input. It indicates the distance in the requested unit (miles or kilometers) between this location and the passed-in location. If no lunit parameter is passed in to specify the unit of measure, the default unit for the locale is used.
bearing string This field applies only for calls that pass in a Latitude and Longitude as input. It indicates the compass direction of this location relative to the passed-in location.