Description of Image Query By Example Search Service

Service URL: http://buscamedia.uc3m.es/iqbe/search.php

This service allows to search similar images to the one provided as example.

The query (POST) needs the followign parameters:

searchtype: type of the search to be performed by the service. There are three possibilities:

random: retrieves a random set of images from the server. It does not need any other parameter.
serverfile: the server uses a file from the server as query. Next parameters are needed:

image_file_name: name of the server file to be used as query.

newfile: the server becomes an image and retrieves similar images. Next parameters are needed:

file: image to be used as query.

Output XML Schema


<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"> 
 <xsd:element name="response"> 
  <xsd:complexType>
   <xsd:all> 
    <xsd:element name="status" minOccurs="1" maxOccurs="1" type="status" /> 
    <xsd:element name="action" minOccurs="1" maxOccurs="1" type="xs:string" /> 
    <xsd:element name="search" minOccurs="1" maxOccurs="1" type="search" /> 
   </xsd:all> 
  </xsd:complexType> 
 </xsd:element> 
 <xsd:complexType name="status"> 
  <xsd:all> 
   <xsd:element name="code" type="xs:int" minOccurs="1" maxOccurs="1"/> 
   <xsd:element name="text" type="xs:string" minOccurs="1" maxOccurs="1"/> 
  </xsd:all> 
 </xsd:complexType> 
 <xsd:complexType name="search"> 
  <xsd:all> 
   <xsd:element name="query" minOccurs="1" maxOccurs="1" type="query" /> 
   <xsd:element name="results" minOccurs="1" maxOccurs="1" type="results" /> 
  </xsd:all> 
 </xsd:complexType> 
 <xsd:complexType name="query"> 
  <xsd:all> 
   <xsd:element name="type" minOccurs="1" maxOccurs="1"> 
    <xsd:simpleType> 
     <xsd:restriction base="xs:string"> 
      <xsd:enumeration value="image" /> 
     </xsd:restriction> 
    </xsd:simpleType> 
   </xsd:element> 
   <xsd:element name="query_image" type="xs:string" minOccurs="1" maxOccurs="1"/> 
  </xsd:all> 
 </xsd:complexType> 
 <xsd:complexType name="results"> 
  <xsd:all> 
   <xsd:element name="image" minOccurs="0" maxOccurs="unbounded" type="image" /> 
  </xsd:all> 
 </xsd:complexType> 
 <xsd:complexType name="image"> 
  <xsd:all> 
   <xsd:element name="id" type="xs:string" minOccurs="1" maxOccurs="1"/> 
   <xsd:element name="URL" type="xs:string" minOccurs="1" maxOccurs="1" /> 
   <xsd:element name="fichero" type="xs:string" minOccurs="1" maxOccurs="1"/> 
   <xsd:element name="extension" type="xs:string" minOccurs="1" maxOccurs="1"/> 
   <xsd:element name="relevance" type="xs:string" minOccurs="1" maxOccurs="1"/> 
 </xsd:complexType> 
</xsd:schema>

Ejemplo XML


<?xml version="1.0" encoding="UTF-8"?> 
<response> 
 <status> 
  <code>0</code> 
  <text>OK</text> 
 </status> 
 <action>Search</action> 
 <search> 
  <query> 
   <type>image</type> 
   <query_image></query_image> 
  </query> 
  <results> 
   <image> 
    <id>1</id> 
    <URL>http://buscamedia.uc3m.es/iqbe/images/00_00_59_06.jpg</URL> 
    <fichero>00_00_59_06.jpg</fichero> 
    <extension>html</extension> 
    <relevance>0</relevance> 
   </image> 
   <image> 
    <id>2</id> 
    <URL>http://buscamedia.uc3m.es/iqbe/images/00_00_58_20.jpg</URL> 
    <fichero>00_00_58_20.jpg</fichero> 
    <extension>html</extension> 
    <relevance>0</relevance> 
   </image> 
  </results> 
 </search> 
</response>