<!--
 -  
 -  This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
 -  project.
 -  
 -  Copyright (C) 1998-2018 OpenLink Software
 -  
 -  This project is free software; you can redistribute it and/or modify it
 -  under the terms of the GNU General Public License as published by the
 -  Free Software Foundation; only version 2 of the License, dated June 1991.
 -  
 -  This program is distributed in the hope that it will be useful, but
 -  WITHOUT ANY WARRANTY; without even the implied warranty of
 -  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 -  General Public License for more details.
 -  
 -  You should have received a copy of the GNU General Public License along
 -  with this program; if not, write to the Free Software Foundation, Inc.,
 -  51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 -  
 -  
-->
<?xml version="1.0" encoding="ISO-8859-1"?>
<refentry id="SO-S-27">
  <refmeta>
    <refentrytitle>SOAP</refentrytitle>
    <refmiscinfo>tutorial</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>SOAP services</refname>
    <refpurpose>Yahoo GeoCode API demo</refpurpose>
  </refnamediv>

<refsect1 id="SO-S-27a">
<title>Overview</title>
<para>
  This example demonstrates how to use Yahoo GeoCode API as a local SOAP service.  </para>
  <para>For more information on Yahoo GoeCode API visit: 
  <ulink url="http://developer.yahoo.net/maps/rest/V1/geocode.html">http://developer.yahoo.net/maps/rest/V1/geocode.html</ulink>
  </para>
</refsect1>

<refsect1 id="SO-S-27b">
  <title>Breakdown</title>
  <itemizedlist>
  <listitem>In the initial state we create a simple procedure that: 
    <itemizedlist>
      <listitem>takes input parameters as described by <ulink url="http://developer.yahoo.net/maps/rest/V1/geocode.html">Yahoo GoeCode API</ulink> page. </listitem>
      <listitem>Generates URL and calls it.</listitem>
      <listitem>returns the XML result formated throught raw.xsl.</listitem>
    </itemizedlist>
  </listitem>
  <listitem>Create SOAP_SO_S_27 user and grant the procedure to it.</listitem>
  <listitem>
  The SOAP service is achieved by defining the /SOAP_SO_S_27 URL to
  have same functionality as using soap_server() function call.
  </listitem>
  <listitem>
  The client uses AJAX to call the service and show the result.
  </listitem>
  </itemizedlist>
</refsect1>

</refentry>
