SOAP リクエストとレスポンスのサンプル

このトピックでは、SOAP リクエストとレスポンスの例を示します。

注: サービス名、オプション名、フィールド名は、最終的に XML 要素となるため、XML 要素名として無効な文字を含んではいけません (例えば、空白は無効です)。詳細については、XML の仕様を参照してください (XML Markup Language)。この要件を満たさないサービスは、サービスとしては機能しますが、Web サービスとして公開することはできません。

SOAP リクエストのサンプル

以下に、SOAP リクエストとレスポンスのサンプルを示します。オプションと行のセクションは使用する Web サービスのメタデータに依存するため、コンポーネントによってメタデータのエントリが異なります。また、user_fields セクションを使うと、変更されずにレスポンスで返されるフィールド値を渡すことができます。

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geoc="http://www.pb.com/spectrum/services/GeoComplete">
   <soapenv:Header/>
   <soapenv:Body>
      <geoc:GeoCompleteRequest>
         <!--Optional:-->
         <geoc:options>
            <!--Optional:-->
            <geoc:Database>bel</geoc:Database>
            <!--Optional:-->
            <geoc:DatabaseSearchOrder></geoc:DatabaseSearchOrder>
            <!--Optional:-->
            <geoc:Path></geoc:Path>
            <!--Optional:-->
            <geoc:GeoCompleteLevel></geoc:GeoCompleteLevel>
            <!--Optional:-->
            <geoc:NoRestriction></geoc:NoRestriction>
            <!--Optional:-->
            <geoc:DistanceFromOrigin></geoc:DistanceFromOrigin>
            <!--Optional:-->
            <geoc:SearchDistance></geoc:SearchDistance>
            <!--Optional:-->
            <geoc:BoundingBox></geoc:BoundingBox>
            <!--Optional:-->
            <geoc:BBoxEast></geoc:BBoxEast>
            <!--Optional:-->
            <geoc:BBoxWest></geoc:BBoxWest>
            <!--Optional:-->
            <geoc:BBoxNorth></geoc:BBoxNorth>
            <!--Optional:-->
            <geoc:BBoxSouth></geoc:BBoxSouth>
            <!--Optional:-->
            <geoc:MatchOnAddressNumber></geoc:MatchOnAddressNumber>
            <!--Optional:-->
            <geoc:GeoCompleteDictionaryPreference></geoc:GeoCompleteDictionaryPreference>
            <!--Optional:-->
            <geoc:CoordinateSystem></geoc:CoordinateSystem>
            <!--Optional:-->
            <geoc:MaxCandidates></geoc:MaxCandidates>
            <!--Optional:-->
            <geoc:SearchRadiusUnit></geoc:SearchRadiusUnit>
            <!--Optional:-->
            <geoc:Locale></geoc:Locale>
            <!--Optional:-->
            <geoc:FuzzyMatch></geoc:FuzzyMatch>
         </geoc:options>
         <!--Optional:-->
         <geoc:input_port>
            <!--Zero or more repetitions:-->
            <geoc:Address>
               <!--You may enter the following 9 items in any order-->
               <!--Optional:-->
               <geoc:AddressLine1>Rijksweg 60</geoc:AddressLine1>
               <!--Optional:-->
               <geoc:City>Bornem</geoc:City>
               <!--Optional:-->
               <geoc:StateProvince>Vlaams Gewest</geoc:StateProvince>
               <!--Optional:-->
               <geoc:PostalCode>2880</geoc:PostalCode>
               <!--Optional:-->
               <geoc:Country>BEL</geoc:Country>
               <!--Optional:-->
               <geoc:Category>Shopping</geoc:Category>
               <!--Optional:-->
               <geoc:OriginLatitude></geoc:OriginLatitude>
               <!--Optional:-->
               <geoc:OriginLongitude></geoc:OriginLongitude>
               <!--Optional:-->
               <geoc:user_fields>
                  <!--Zero or more repetitions:-->
                  <geoc:user_field>
                     <geoc:name></geoc:name>
                     <geoc:value></geoc:value>
                  </geoc:user_field>
               </geoc:user_fields>
            </geoc:Address>
         </geoc:input_port>
      </geoc:GeoCompleteRequest>
   </soapenv:Body>
</soapenv:Envelope>

SOAP レスポンスのサンプル

以下に、SOAP レスポンスのサンプルを示します。

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns3:GeoCompleteResponse xmlns:ns2="http://spectrum.pb.com/" xmlns:ns3="http://www.pb.com/spectrum/services/GeoComplete">
         <ns3:output_port>
            <ns3:Address>
               <ns3:AddressLine1>Rijksweg 60</ns3:AddressLine1>
               <ns3:City>Bornem</ns3:City>
               <ns3:County>Mechelen</ns3:County>
               <ns3:Country>BEL</ns3:Country>
               <ns3:LastLine>2880 Bornem</ns3:LastLine>
               <ns3:Latitude>51.09881</ns3:Latitude>
               <ns3:Longitude>4.2529</ns3:Longitude>
               <ns3:PostalCode>2880</ns3:PostalCode>
               <ns3:StateProvince>Vlaams Gewest</ns3:StateProvince>
               <ns3:Name>DreamLand</ns3:Name>
               <ns3:Type>1</ns3:Type>
               <ns3:Distance>-0.0</ns3:Distance>
               <ns3:DistanceUnit>KILOMETERS</ns3:DistanceUnit>
               <ns3:FormattedString>DreamLand, Rijksweg 60, 2880 Bornem</ns3:FormattedString>
               <ns3:BrandName>DreamLand</ns3:BrandName>
               <ns3:IsUserDictionary>false</ns3:IsUserDictionary>
               <ns3:Category>Shopping</ns3:Category>
               <ns3:SubCategory>Toys and Games</ns3:SubCategory>
               <ns3:micode>10010374</ns3:micode>
               <ns3:http>www.dreamland.be</ns3:http>
               <ns3:telnum>+(32)-(3)-8254566</ns3:telnum>
               <ns3:email>dreamland@dreamland.be</ns3:email>
               <ns3:featureID>10560201478679</ns3:featureID>
               <ns3:StreetNameMatch>true</ns3:StreetNameMatch>
               <ns3:AddressNumberMatch>true</ns3:AddressNumberMatch>
               <ns3:AreaName1Match>true</ns3:AreaName1Match>
               <ns3:AreaName3Match>true</ns3:AreaName3Match>
               <ns3:CategoryMatch>true</ns3:CategoryMatch>
               <ns3:user_fields>
                  <ns3:user_field>
                     <ns3:name/>
                     <ns3:value/>
                  </ns3:user_field>
               </ns3:user_fields>
            </ns3:Address>
         </ns3:output_port>
      </ns3:GeoCompleteResponse>
   </soap:Body>
</soap:Envelope>