Repository navigation
Backend 2.6 Schnittstellen
Verantwortlich: Tobias
Die Suche von Locations - im konkreten Fall Cocktail-Bars - und das Erfassen von detailierten Daten, erfolgt über die Nutzung von einem externen Datenlieferanten. Als externer Datenlieferant stehen zwei verschiedene Dienstleister zur Verfügung: Foursquare.com und Yelp.de. Die Analyse und Auswahl einer dieser Dienstleister erfolgt weiter unten.
Die Anbindung an die zur Verfügung stehenden Dienste des externen Datenlieferanten muss über eine REST Schnittstelle realisiert werden. Die Entwicklung und der finale Aufbau der REST Schnittstelle zum ausgewählten Dienstleister ist auf folgender Seite detailiert beschrieben.
Zur engeren Auswahl beim Finden eines externen Datenlieferanten standen die Dienstleister Yelp und Foursquare. Beide Dienste bieten eine standortbasierte Suchfunktion über Keywords, sowie eine Suchfunktion einer einzelnen Location über eine ID.
Foursquare ist ein amerikanischer Dienst zum Suchen von Restaurants, Bars, Cafes, etc. in weiten Teilen Amerikas und Europas. Inzwischen ist die Nutzerbasis in deutschen Großstädten so groß, dass kaum eine Bar nicht von Foursquare erfasst ist. Die Interaktion basiert auf der Nutzung von REST-Schnittstellen. Die Nutzung des Dienstes erfordert jedes Mal eine Authentifizierung des App-Anbieters. Die dafür erforderlichen Daten sind im Abschnitt Bewertungsportale aufgelistet.
Nützliche Einschränkungen der Suchergebnisse:
- LL: Longitude, Latitude
- Radius: Umkreis in Metern
- Section: Kategorie-Angabe, wie 'drinks', 'food', 'coffee'
- Limit: Einschränkung der Ergebnisse bis max. 50
- Price: Preis-Angabe von 1 (günstig) bis 4 (teuer)
Die Ergebnisse enthalten ausführliche Informationen über
- Adresse
- GPS-Informationen
- Öffnungszeiten
- Preis
- Bewertungen
- Bar-Bild
- Kategorie -> Hieraus kann eine Beschreibung erstellt werden
Eine Einschränkung bei Foursquare ist das Limit von maximal 5.000 Suchanfragen pro Stunde, was für den Umfang der Happy-Hour-App kein Problem darstellen dürfte.
Nötige Angaben: 'Powered by Foursquare' gut sichtbar pro Seite.
Yelp ist wie Foursquare ein amerikanischer Dienst zum Suchen von Restaurants, Bars, Cafes, etc. in weiten Teilen Amerikas und Europas. Auch Yelp verfügt über eine umfangreiche Nutzerbasis, die meisten Bars in deutschen Großstädten sind registriert und sind mit zahlreichen Bewertungen versehen. Die Interaktion funktioniert über eine REST-Schnittstelle. Eine Authentifizierung des App-Herausgebers ist bei Nutzung des Dienstes nicht nötig.
Nützliche Einschränkungen der Suchergebnisse:
- location: Standort als Basis für Suchvorgänge
- radius_filter: Umkreis in Metern
- term: Kategorie-Angabe, wie 'drinks', 'food', 'coffee'
- limit: Einschränkung der Ergebnisse bis max. 40
Die Ergebnisse enthalten ausführliche Informationen über:
- Adresse
- GPS-Informationen
- Öffnungszeiten
- Preis
- Bewertungen
- Bar-Bild
- Kategorie -> bei weitem nicht bei allen Bars angegeben
Nötige Angaben: Alle Daten aus Yelp müssen durch das Yelp-Logo auffällig gekennzeichnet werden.
Beim Vergleich der beiden Dienste Yelp und Foursquare fällt auf, dass sich beide Lösungen im Funktionsumfang weitgehend ähneln. Aus umfangreichen Vergleichen von Suchergebnissen ging hervor, dass Daten zu Locations bei Foursquare beinahe durchgehend und sehr detailliert vorhanden sind. Bei Yelp hingegen existieren in vielen Fällen Lücken, sehr auffällig beispielsweise bei der Einordnung der Locations in Kategorien. Während Foursquare eine Bar konkret als "Mexikanische Bar"/"Nightlife Club" bezeichnet, liefert Yelp lediglich "Bar". Zwar ist das nur stellenweise der Fall, doch ist eine lückenlose Beschreibung von Bars für den Nutzer der Happy-Hour-App sehr nützlich. Da Yelp das Platzieren seines Produktlogos für alle verwendete Daten fordert, Foursquare hingegen nur an einer Stelle pro Seite erwähnt werden will, geht die Tendenz auch hier eher in Richtung Foursquare. Zu viele Produktlogos auf engem Raum sind für den User eher nervig.