Exemplos da API Images

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. Para apps criados após fevereiro de 2020, o REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criados antes dessa data, o ID da região é opcional no URL.

Saiba mais sobre IDs de região.

OK

Saiba como fazer upload, transformar, armazenar e disponibilizar imagens dinamicamente usando a API Images. Este exemplo descreve como postar mensagens em um quadro público e fazer upload de um avatar com sua saudação.

Nesta página, você verá como usar as APIs e os serviços legados em pacote. Ela só pode ser executada em ambientes de execução de primeira geração no ambiente padrão do App Engine. Se você estiver atualizando para o ambiente de execução do Python 3 do App Engine, consulte o guia de migração para saber mais sobre as opções de migração para serviços incluídos legados.

Como criar um modelo de imagem no Datastore

Você precisa atualizar o modelo a partir do exemplo de livro de visitas para armazenar a imagem enviada como um blob.

class Greeting(ndb.Model):
    """Models a Guestbook entry with an author, content, avatar, and date."""
    author = ndb.StringProperty()
    content = ndb.TextProperty()
    avatar = ndb.BlobProperty()
    date = ndb.DateTimeProperty(auto_now_add=True)

Como fazer upload de imagens do usuário

Você precisará modificar o formulário HTML para permitir que o usuário faça upload de uma imagem:

1. Adicione um campo que permita ao usuário selecionar um arquivo do computador para upload.

2. Adicione o atributo enctype à tag do formulário e especifique que esta é uma postagem de formulário com várias partes.

   self.response.out.write("""
         <form action="/sign?%s"
               enctype="multipart/form-data"
               method="post">
           <div>
             <textarea name="content" rows="3" cols="60"></textarea>
           </div>
           <div><label>Avatar:</label></div>
           <div><input type="file" name="img"/></div>
           <div><input type="submit" value="Sign Guestbook"></div>
         </form>
         <hr>
         <form>Guestbook name: <input value="%s" name="guestbook_name">
         <input type="submit" value="switch"></form>
       </body>
     </html>""" % (urllib.urlencode({'guestbook_name': guestbook_name}),
                   cgi.escape(guestbook_name)))

3. Atualize o gerenciador do livro de visitas para receber os dados de imagem da postagem do formulário e armazená-los como um blob no armazenamento de dados.

   class Guestbook(webapp2.RequestHandler):
       def post(self):
           guestbook_name = self.request.get('guestbook_name')
           greeting = Greeting(parent=guestbook_key(guestbook_name))
   
           if users.get_current_user():
               greeting.author = users.get_current_user().nickname()
   
           greeting.content = self.request.get('content')
   
           avatar = self.request.get('img')
           avatar = images.resize(avatar, 32, 32)
           greeting.avatar = avatar
           greeting.put()
   
           self.redirect('/?' + urllib.urlencode(
               {'guestbook_name': guestbook_name}))

Como transformar imagens

Para criar avatares de 32 x 32, siga estas etapas:

1. Importe o módulo google.appengine.api.images.

   from google.appengine.api import images

2. Chame a função resize e passe os dados da imagem.

   avatar = images.resize(avatar, 32, 32)

Como disponibilizar imagens dinamicamente

Para disponibilizar imagens, siga estas etapas:

1. Crie um gerenciador de imagens que disponibilize dinamicamente imagens fora do caminho /img.

   class Image(webapp2.RequestHandler):
       def get(self):
           greeting_key = ndb.Key(urlsafe=self.request.get('img_id'))
           greeting = greeting_key.get()
           if greeting.avatar:
               self.response.headers['Content-Type'] = 'image/png'
               self.response.out.write(greeting.avatar)
           else:
               self.response.out.write('No image')

2. Atualize o HTML para exibir essas imagens disponibilizadas dinamicamente.

   self.response.out.write('<div><img src="/img?img_id=%s"></img>' %
                           greeting.key.urlsafe())
   self.response.out.write('<blockquote>%s</blockquote></div>' %
                           cgi.escape(greeting.content))

Você precisará atualizar o HTML do livro de visitas para passar a chave da saudação para o gerenciador de imagem, já que ele recebe o img_id da solicitação.

Como implantar o aplicativo no App Engine

Para fazer upload do aplicativo de livro de visitas, execute o seguinte comando no diretório guestbook do aplicativo em que os arquivos app.yaml e index.yaml estão localizados:

gcloud app deploy app.yaml index.yaml

Os índices do Datastore podem levar algum tempo para serem gerados antes que o aplicativo fique disponível. Se os índices ainda estiverem sendo gerados, você receberá uma mensagem NeedIndexError ao acessar seu aplicativo. Esse erro é temporário. Tente um pouco mais tarde se você receber esse erro.

Para saber mais sobre como implantar o aplicativo na linha de comando, consulte Como implantar um aplicativo Python.

Como ver o aplicativo implantado

Para iniciar seu navegador e visualizar o aplicativo em https://PROJECT_ID.REGION_ID.r.appspot.com, execute o comando a seguir:

gcloud app browse