Issue #25: Add accent correction for yelp->TA queries; add improvemen…

…ts notes.

See code comments for details and improvement notes.

app/providers/tripadvisor.py

@@ -1,6 +1,9 @@
+# coding=utf-8
+
 import re
 import requests
 
+from app import util
 from app.clients import tripadvisorkey
 
 idPattern = re.compile("-d([0-9]*)-")
@@ -19,7 +22,9 @@ def resolve(idObj):
 
 
 TRIP_ADVISOR_LOC_MAPPER_API = 'http://api.tripadvisor.com/api/partner/2.0/location_mapper/{}'
-LOC_MAPPER_DEFAULT_PARAMS = { 'key': tripadvisorkey + '-mapper' }
+
+
+def _get_loc_mapper_default_params(): return { 'key': tripadvisorkey + '-mapper' }
 
 
 def search(coord, query):
@@ -41,6 +46,34 @@ def search(coord, query):
     coord_str = ','.join([str(x) for x in coord])
     url = TRIP_ADVISOR_LOC_MAPPER_API.format(coord_str)
 
-    params = dict(LOC_MAPPER_DEFAULT_PARAMS)
+    params = _get_loc_mapper_default_params()
     params['q'] = query
+    res = requests.get(url, params).json()
+    if not _search_query_has_results(res) and util.str_contains_accents(query):
+        res = _search_without_accents(query, url)
+
+    # TODO: Further improve results by querying TA without a query_str and doing our own
+    # name matching on the results. For example, "Mariposa Baking" (from Yelp) finds no matches
+    # despite "Mariposa" being on TA. For a full list of relevant places, see `docs/yelp_ta_name_mismatches.yml`.
+    #
+    # Implementation notes:
+    #   - TA will return at most 10 results
+    #   - A place won't necessarily exist in TA (or at that location, e.g. Señor Sisig is a food truck).
+    #   - Custom fuzzy matching may introduce more error, making a trade-off between some error & missing data.
+    #   - Could also compare address (not just name!)
+    return res
+
+
+def _search_without_accents(query, url):
+    """Searches TA location_mapper API, removing the query string's accents.
+
+    Why would you want to? Yelp place names are frequently listed with accents - TA are not, potentially causing
+    name mismatches. I've found removing accents corrects some places (e.g. La Mar Cebichería Peruana).
+    """
+    accent_stripped_str = util.strip_accents(unicode(query))
+    params = _get_loc_mapper_default_params()
+    params['q'] = accent_stripped_str
     return requests.get(url, params).json()
+
+
+def _search_query_has_results(res): return len(res['data']) > 0

docs/yelp_ta_name_mismatches.yml

@@ -0,0 +1,74 @@
+---
+# A list of places that exist on TripAdvisor but are not found when putting a
+# Yelp place name directly into the TA location_mapper/ API. See
+# `app.providers.tripadvisor.search` for motivations for this list.
+#
+# Yelp place names come first (even indices), followed by the associated
+# TripAdvisor name (odd indices).
+#
+# Consider using this file for unit testing. :) Not that some names may not be
+# correctable.
+
+sf:
+    - Frog Hollow Farm Market & Cafe
+    - Frog Hollow Farm
+    - Mariposa Baking
+    - Mariposa
+    - Mourad Restaurant
+    - Mourad
+    - DragonEats
+    - dragonEats
+    - Blue Bottle Coffee Stand
+    - Blue Bottle Coffee Ferry Building
+
+yvr:
+    - Guu with Otokomae
+    - Otokomae at Kitanoya Guu
+    - Canra Srilankan Cuisine
+    - Canra Sri Lankan Plus
+    - Nuba Gastown
+    - Nuba Restaurant
+    - The Sardine Can
+    - Sardine Can
+    - Jam Cafe on Beatty
+    - Jam Cafe YVR
+    - Brioche Urban Baking & Catering
+    - Brioche
+    - Finch's Tea & Coffee House
+    - Finch’s Teahouse
+    - La Taqueria Pinche Taco Shop
+    - La Taqueria
+
+chicago:
+    - Fremont Chicago
+    - Fremont
+    - Osaka Sushi Express & Fresh Fruit Smoothies
+    - Osaka Sushi Express
+    - MingHin Cuisine
+    - Ming Hin Cuisine
+    - Eddie Vs Prime Seafood and Steak
+    - Eddie V’s Prime Seafood
+    - Peach And Green
+    - Peach & Green
+    - Volare Ristorante Italiano
+    - Volare
+    - Cherry Circle Room
+    - Cherry Circle
+    - Brightwok Kitchen
+    - Brightwok
+    - Doc Bs Fresh Kitchen - River North
+    - Doc B’s Fresh Kitchen
+
+nashville:
+    - Crazy Town Nashville
+    - Crazy Town
+    - The Standard At The Smith House
+    - The Standard
+    - Cafe Le Crumbs
+    - La Crumbs Cafe
+    - Rodizio Grill The Brazilian Steakhouse
+    - Rodizio Grill - Nashville
+    - Tin Roof Broadway
+    - Tin Roof
+    - Rae's Gourmet Catering & Sandwich Shoppe
+    - Rae’s Gourmet Sandwich Shoppe