Exemplos da API Images

ID da região

O REGION_ID é um código abreviado que a Google atribui com base na região que seleciona quando cria a sua app. O código não corresponde a um país ou uma província, embora alguns IDs de regiões possam parecer semelhantes aos códigos de países e províncias usados frequentemente. Para apps criadas após fevereiro de 2020, REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criadas antes desta data, o ID da região é opcional no URL.

Saiba mais acerca dos IDs de regiões.

Saiba como carregar, transformar, armazenar e publicar imagens dinamicamente através da API Images. Este exemplo descreve como publicar mensagens num fórum público e carregar um avatar com a sua saudação.

Criar um modelo de imagem no Datastore

Tem de atualizar o modelo do exemplo do livro de visitas para armazenar a imagem carregada 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)

A carregar imagens de utilizadores

Tem de modificar o formulário HTML para permitir que o utilizador carregue uma imagem:

  1. Adicione um campo que permita ao utilizador selecionar um ficheiro do respetivo computador para carregar.

  2. Adicione o atributo enctype à etiqueta de formulário e especifique que se trata de uma publicação de formulário multipartes.

    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 controlador do livro de visitas para obter os dados da imagem da publicação do formulário e armazená-los como um blob no arquivo 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}))

Transformar imagens

Para criar avatares de 32 x 32, tem de:

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

    from google.appengine.api import images

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

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

Publicação dinâmica de imagens

Para publicar imagens, tem de:

  1. Crie um controlador de imagens que disponibilize dinamicamente imagens a partir 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 apresentar estas imagens publicadas 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))

Tem de atualizar o HTML do livro de visitas para transmitir a chave da saudação ao controlador de imagens, uma vez que recebe o img_id do pedido.

Implementar a app no App Engine

Para carregar a app de livro de visitas, execute o seguinte comando a partir do diretório guestbook da sua aplicação onde se encontram os ficheiros app.yaml e index.yaml:

gcloud app deploy app.yaml index.yaml

Os índices do Datastore podem demorar algum tempo a ser gerados antes de a sua aplicação estar disponível. Se os índices ainda estiverem em processo de geração, recebe uma mensagem quando aceder à sua app. Este erro é transitório, por isso, tente um pouco mais tarde se receber este erro inicialmente.NeedIndexError

Para saber mais sobre a implementação da sua app a partir da linha de comandos, consulte o artigo Implementar uma app Python.

Ver a aplicação implementada

Para iniciar o navegador e ver a app em https://PROJECT_ID.REGION_ID.r.appspot.com, execute o seguinte comando:

gcloud app browse