PICALIKE UPLOAD API DOKUMENTATION

Transkript

1 PICALIKE UPLOAD API DOKUMENTATION

2 2 INDEX EINFÜHRUNG PICALIKE 3 ABLAUF 3 VORAUSSETZUNG 4 PFLICHTFELDER 4 WEITERE FELDER 4 API 5 ÄHNLICHKEITSSUCHE MIT UPLOAD 5 DEMO-RESULT 6 WEITERE EINSTELLUNGEN 7 KONTAKT 8

3 3 EINFÜHRUNG PICALIKE Die picalike GmbH ( picalike ) hat eine Bildanalyse-Technologie entwickelt, die beispielsweise nach passenden (Produkt-)Bildern anhand von Fotos sucht. Für das menschliche Denken ist die Ähnlichkeit eines der Basiskriterien und entspricht dem Entscheidungsprozess im menschlichen Gehirn. Das wird durch die lernenden picalike- Produkte in visueller Hinsicht aufgegriffen. ABLAUF Die Upload Bildanalyse mit picalike funktioniert sehr einfach: 1. Anhand einer CSV-Datei werden die Produktinformationen an picalike übermittelt. 2. Danach werden die Produktbilder abgeholt und Veränderungen innerhalb des Bildes werden geprüft. 3. Die Bilder durchlaufen einen Prüfungsprozess in dem die Qualität der Datei überprüft wird (nur bei veränderten Dateien). Hier wird versucht bei Bedarf Hintergründe zu entfernen, Personen werden erkannt und entfernt, Farbkorrekturen werden durchgeführt und die Bilder werden auf eine für das System passende Größe skaliert. 4. Die überprüften Bilder werden an den Indexer übermittelt. Dieser gruppiert die Produkte anhand ihrer Kategorien und erstellt Indizes aus Ähnlichkeiten (Kombination von Farbe, Form, Textur etc. oder einzelnen Gewichtungen wie bspw. Form). 5. Nachdem die Indizes erstellt worden sind, stehen die Bilder dem picalike-server zur Verfügung und werden mit den Fotos, die über der Upload API übermittelt wurden, verglichen.

4 4 VORAUSSETZUNG Voraussetzung für die Ähnlichkeitssuche mit picalike ist die CSV-Datei für die Kommunikation zwischen einem Shop und picalike. Darin werden Informationen zu den Produkten übermittelt wie zum Beispiel die URL der zu analysierenden Bilder, die Produktartikelnummer und die Kategorie. Voraussetzungen beim Upload sind, dass das Bild nicht größer ist als 6 MB ist, dass das Produkt sich im Zentrum des Bildes befindet, es komplett zu erkennen ist und den größten Teil des Bildes einnimmt. Um die Qualität der Resultate weiter zu steigern, sollte die Rotation des übermittelten Bildes beachtet und ggf. vor der Übermittlung korrekt rotiert werden. Die Information über die Rotation des Bildes ist in den ExIF Metadaten eines Fotos (JPG) enthalten. ZUSAMMENGEFASST» CSV Datei für den Produktimport» Bild < 6MB» Produkt sollte zentral auf dem Foto gut erkennbar sein PFLICHTFELDER SHOP FEED» Produktartikelnummer» URL des Produktbildes» Kategorie des Produktes» Deeplink (bei Nutzung des Recommendors) WEITERE FELDER SHOP FEED» Preis» Marke» Name» Logo der Marke» URL eines Thumbnails» Bewertungsnote» Geschlecht» Farbe» Weitere kundenspezifische Felder (e.g. sog. Business Values )

5 5 API ÄHNLICHKEITSSUCHE MIT UPLOAD Demo: API-Aufruf (Beispiel 1): POST { key=cgljc2ltawxhcjo limit=32 cat=herren-t-shirt } API-Aufruf (Beispiel 2): <form action="index.php" method="post" enctype="multipart/form-data> <input name="image" type="file" size="50" maxlength="1000" accept="image/*"> <select> <option value="herren-t-shirt">t-shirt</option> </select> <input type="hidden" name="key" value="cgljc2ltawxhcjo"> <input type="hidden" name="limit" value="36"> </form> Parameter: image = Bild als POST File [POST] url = URL statt File POST. In diesem Fall lädt picalike das Bild herunter. [POST] key = eindeutiger Kunden-API-Schlüssel [POST] cat = Kategorie, in der nach ähnlichen Produkten gesucht werden soll [POST] limit = Anzahl der gewünschten Resultate (max. 1000) [POST] Die Resultate sind nach der Ähnlichkeit gewichtet und werden als JSON File zurückgegeben.

6 6 Resultat als JSON: { "title": "picalike Request", "link": " "description": "", "modified": " CET01:31:173600", "generator": " "found": [ { "id":"27537", "img": " "name":"bench T-Shirt celestial", "gender":"1", "price": 29.90, "brand": "Bench", "w": 1, "location": " }, { "id":"32189", "img": " "name":"cleptomanicx T-Shirt port blue", "gender":"1", "price": 14.90, "brand": "Cleptomanicx", "w": , "location": " },..., { "id":"28277", "img": " "name":"humr T-Shirt fuu blue", "gender":"1", "price": 24.90, "brand": "Humr", "w": , "location": " }] }

7 7 WEITERE EINSTELLUNGEN Es bestehen noch weitere Einstellungen. Diese müssen von picalike intern umgesetzt werden, da hier das System auf den Kunden kalibriert wird und die Algorithmen nach den spezifischen Kundenwünschen lernen. Es ist beispielsweise möglich bei den visuellen Empfehlungen von picalike eine Grenze anzugeben, bis zu welcher Gewichtung Resultate geliefert werden dürfen. Bei picalike Referenzierung/Empfehlung können auch - abgesehen von der Ähnlichkeit - weitere Entscheidungskriterien für die Empfehlung vorgegeben werden: nur Produkte von der gleichen (oder einer bestimmten) Marke, nur mit gleicher Farbe, nur Form oder eine prozentuale Preisabweichung können so berücksichtigt werden. Diese Einstellungen erfolgen nach Absprache mit picalike und werden in der Folge von picalike umgesetzt.

8 8 KONTAKT picalike GmbH Wendenstrasse 130 D Hamburg Daniel Raschke p.: f.: c.: m.: [email protected] Sebastian Kielmann p.: f.: c.: m.: [email protected]