La compatibilité de Python 2 n'est plus assurée par la communauté. Nous vous recommandons de migrer les applications Python 2 vers Python 3.

Installer un exemple d'application pour l'API Search

Amy Unruh, octobre 2012
Relations Google Developer

Présentation

Dans cette leçon, nous allons installer un exemple d'application de recherche de produit. Ainsi, vous allez pouvoir vérifier que vous êtes prêt à développer et déployer une application App Engine et profiter d'une plate-forme d'expérimentation pour tester l'API Search tout au long de ce cours.

Objectifs

  • Confirmer que vous êtes prêt à créer et déployer des applications App Engine.
  • Installer un exemple d'application de recherche de produit.

Prérequis

Présentation de l'exemple d'application

Nous allons prendre pour exemple une application de recherche de produits. Lors de l'initialisation, elle crée un index du document de produits à partir d'exemples de données produit et un deuxième index à partir d'exemples de données de localisation du magasin. Les documents de localisation du magasin incluent des informations sur le point géographique (latitude et longitude).

L'application affiche les produits et invite les utilisateurs à évaluer les produits en envoyant des avis. Elle accepte la recherche de texte intégral sur les informations produit indexées à l'aide de requêtes basées sur des termes simples ou à l'aide d'une syntaxe de requête plus complexe. Les résultats de recherche peuvent être triés de différentes manières, y compris en fonction de la note moyenne du produit ou d'une métrique de pertinence terme-fréquence. Les résultats de recherche se servent de la fonctionnalité d'extraction de l'API Search pour afficher les sous-chaînes saillantes des champs du document. L'application illustre également l'utilisation des décalages et des limites de Search pour accepter la pagination.

Exemple de recherche de produits
Figure 1 : Exemple de recherche de produits.

La capture d'écran ci-dessus illustre une page de résultats de recherche typique. L'utilisateur a recherché des éléments dans la catégorie "books" (livres). La requête se présente sous la forme suivante :

(stories OR novel) price > 20

Elle nous donne une indication sur le langage de requête compatible avec l'API Search. Même si cette requête semble plus complexe que prévu pour l'utilisateur moyen, cet exemple d'application est pensé pour vous aider à expérimenter avec la syntaxe des requêtes. Vous remarquerez que les résultats correspondants affichent des extraits de description avec des termes de recherche en gras, et que nous avons trié les résultats de la recherche en fonction de l'évaluation du produit.

Grâce aux fonctionnalités Geosearch de l'API Search, les utilisateurs peuvent également rechercher des magasins à proximité, comme illustré ci-dessous :

Trouver des magasins à proximité de l'utilisateur à l'aide de Geosearch
Figure 2 : Trouver des magasins à proximité de l'utilisateur à l'aide de Geosearch.

Le formulaire Geosearch est accessible lors de l'affichage des détails d'un produit. Actuellement, Geosearch n'est compatible qu'avec les applications déployées. L'application indique également comment supprimer des documents, créer des documents, indexer et réindexer les données produit par lots.

Installer et exécuter l'exemple d'application

Avant d'installer l'exemple d'application, assurez-vous que Python et le SDK App Engine sont correctement installés. Vous devez également maîtriser les principes de base du lancement et du déploiement d'une application. Le guide de démarrage rapide vous accompagne tout au long de ce processus. Téléchargez ensuite l'exemple d'application. Vous pouvez effectuer une extraction en lecture seule des exemples de code de recherche App Engine comme suit :

git clone https://github.com/GoogleCloudPlatform/appengine-search-python-java.git

Suivez les instructions du fichier README inclus pour exécuter l'application sur le serveur Web de développement (dev_appserver.py).

Une fois l'application en cours d'exécution, initialisez ses exemples de données. Comme indiqué dans le fichier README, il suffit de se connecter en tant qu'administrateur, puis de cliquer sur le lien Admin/Add sample data (Administrateur/Ajouter les exemples de données) dans la barre latérale, puis sur Delete all datastore and index product data, then load in sample product data (Supprimer l'intégralité du magasin de données et des données produit de l'index, puis charger les exemples de données produit). Actuellement, le serveur Web de développement n'est pas compatible avec toutes les fonctionnalités de l'API Search (telles que Geosearch). Il est donc possible de déployer l'application sur appspot.com. Il vous faudra peut-être créer un ID application avant de commencer.

Après avoir déployé l'application et initialisé ses données, testez-la en saisissant quelques requêtes simples dans le champ de recherche. Par exemple, essayez la requête suivante :

(stories OR novel) price < 10

Vous pouvez également cliquer sur le bouton Search (Rechercher) sans saisir de contraintes de requête, et parcourir tous les exemples de produits du petit ensemble de données. Vous trouverez les exemples de données dans le répertoire data de l'application. Si vous le souhaitez, vous pouvez essayer de modifier certains des champs, puis les réinitialiser.

Résumé et vérification

Dans cette leçon, vous avez installé un exemple d'application de recherche de produits App Engine qui utilise l'API Search. Dans les prochaines leçons, le code de l'application servira à illustrer des exemples de manière concrète et à effectuer des tests. Vous pourrez également faire des expériences avec la syntaxe des requêtes de l'API Search via son interface de recherche. Dans la prochaine leçon, vous allez découvrir les bases de l'API Search.