Como instalar um aplicativo de API de exemplo de pesquisa

Amy Unruh, out de 2012
Relações com desenvolvedores do Google

Introdução

Nesta lição, instalaremos um aplicativo de amostra de pesquisa de produtos. Isso ajudará você a verificar se suas configurações permitem o desenvolvimento e a implantação de um aplicativo do App Engine. Oferecemos também uma plataforma para realizar experimentos com a API Search ao longo deste curso.

Objetivos

  • Confirmar se você está configurado para criar e implantar aplicativos do App Engine
  • Instalar um aplicativo de amostra de pesquisa de produtos

Pré-requisitos

Introdução ao aplicativo de amostra

Nosso programa de amostra é um aplicativo de pesquisa de produtos. Na inicialização, ele cria um índice de documento do produto a partir dos dados do produto de amostra e um segundo índice dos dados do local de armazenamento de amostra. Os documentos do local de armazenamento incluem informação geográfica, latitude e longitude.

No aplicativo são mostrados os produtos para que os usuários os classifiquem a partir do envio de avaliações. É possível fazer pesquisa de texto completo sobre as informações do produto indexado usando tanto consultas simples, baseadas em termos, quanto sintaxes de consulta mais complexas. Os resultados das pesquisas podem ser classificados de várias maneiras, inclusive pela classificação média do produto e por uma métrica de relevância da frequência de um termo. Esses resultados usam o recurso snippeting da API Search para exibir substrings de campo de documento salientes. No aplicativo também é demonstrado o uso de deslocamentos de pesquisa e os limites para oferecer suporte à paginação.

Um exemplo de pesquisa de produto
Figura 1: Um exemplo de pesquisa de produto.

A captura de tela acima mostra uma página de resultados de pesquisa típica. O usuário pesquisou itens na categoria "livros" e a consulta é:

(stories OR novel) price > 20

dando uma sugestão da linguagem de consulta compatível com a API Search. Essa consulta específica é mais complexa do que é esperado do usuário médio, mas criamos nosso aplicativo de exemplo para que possamos fazer testes com a sintaxe da consulta. Você perceberá que os resultados correspondentes mostram snippets de descrição com termos de pesquisa em negrito e que classificamos os resultados da pesquisa por classificação do produto.

Ao mostrar os recursos de Geosearch da API Search, os usuários também podem pesquisar por locais de lojas próximas a eles, conforme mostrado abaixo:

Usando Geosearch para encontrar lojas perto do usuário
Figura 2: Usando o Geosearch para encontrar lojas próximas ao usuário.

O formulário Geosearch é acessado ao visualizar os detalhes de um produto. Atualmente, a Geosearch é compatível apenas com aplicativos implantados. Com o aplicativo também é possível ver como excluir documentos, criar novos documentos e realizar a indexação de lote e a reindexação dos dados do produto.

Como instalar e executar o aplicativo de exemplo

Para instalar o aplicativo de exemplo, primeiro verifique se o Python e o SDK do App Engine estão instalados corretamente e se você entendeu as noções básicas para a inicialização e a implantação de um aplicativo. O Guia de início rápido orienta você nesse processo. Em seguida, faça o download do aplicativo de exemplo. É possível fazer uma verificação somente leitura dos exemplos de código de pesquisa do App Engine, como esta:

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

Siga as instruções do arquivo README incluído para executar o aplicativo no servidor da Web de desenvolvimento (dev_appserver.py).

Depois que o aplicativo estiver em execução, inicialize os respectivos dados de amostra. Conforme descrito no arquivo README, isso envolve fazer login como administrador e clicar no link Administrador/Adicionar dados de amostra na barra lateral, seguido pelo link Excluir todos os dados do produto de armazenamento de dados e do índice e, em seguida, carregar nos dados do produto de amostra. O Development Web Server não é compatível atualmente com todos os recursos da API Search, como o Geosearch. Por isso, pode ser que você queira implantar o aplicativo em appspot.com. É possível que primeiro você precise criar um código de aplicativo para ele.

Depois de implantar o aplicativo e inicializar os respectivos dados, teste-o digitando algumas consultas simples de teste na caixa de pesquisa. Por exemplo, tente:

(stories OR novel) price < 10

Também é possível clicar no botão Pesquisar, sem inserir restrições de consulta e percorrer todos os produtos de amostra no pequeno conjunto de dados. Você encontrará os dados de amostra no diretório data do aplicativo. Se quiser, tente alterar alguns dos campos e reinicializar.

Resumo e revisão

Nesta lição, você instalou um aplicativo de amostra de pesquisa de produtos do App Engine que usa a API Search. Nas próximas lições, você aprenderá a usar o código do aplicativo como uma fonte de exemplos concretos e experiências, além de praticar com a sintaxe de consulta da API Search por meio de sua interface de pesquisa. Iniciaremos a próxima lição analisando os princípios básicos da API Search.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Python 2