WMTransfer Wiki
Geo service interfaces

GEOWM.INPUTXML Service

This interface allows automatic uploading to WebMoney GeoService server the list of user WM-objects of certain type.

XML file format for GEOWM.INPUTXML service:

The example below describes one user object (exchange agency):

<?xml version="1.0" encoding="windows-1251"?>
<wmobjects>
 <row 
  sid="30482" 
  citid="12918" 
  name="Association &quot;WMEXPRESS&quot; in Moscow" 
  wmid="477230148314" 
  web="http://wmmoscow.com/" 
  email="" 
  type="1" 
  addr="17 Bolshaya Ordynka" 
  worktime="Monday - Friday, from 10:30 till 19:00" 
  phone="(901)530xxx1, (901)530xxx2" 
  mid="16" 
  mid2="0" 
  dopinfo="exchanging WM*, EGOLD, Yandex.Money. Adding and withdrawing WebMoney in Moscow. Cashless adding and withdrawing WebMoney and E-Gold"
  help="" 
  lng=""
  lat="" 
  direction="3" 
  lang="ru-RU"
  />
</wmobjects>

Requirements to GEOWM.INPUTXML file:

• The file must begin with <wmobjects> opening tag and end with the </wmobjects> tag.
• One <row /> tag is a string containing data about one object.
• The file must be saved in windows-1251 encoding.
• All objects must be geographically binded to WebMoney GeoService geodata database, i.e. each object must have a unique number (ID) of the place (city) where it is located.
• The following masking must be applied to all unallowed symbols:
• Double quotes <"> must be replaced with &quot;
• Greater than sign “>” must be replaced with &gt;
• Less than sign “<” must be replaced with &lt;

Each XML batch must not exceed 200 (maximum) strings in one data set. To update the data, having greater number of strings in one set, the web-site update service calls the registered URL several times, with different FirstId parameters, specifying maximum SID of the previous data set. For correct operation of the update system, each data set batch (200 strings) must have LastID specified. LastId is the ID of the last string in one data set.

Its format is described below:

    http://yoursite.com/yourservice/dataxml?fisrtid=0 (lastid=200)
    http://yoursite.com/yourservice/dataxml?fisrtid=200 (lastid=400)
    http://yoursite.com/yourservice/dataxml?fisrtid=400 (lastid=600)
    .
    .
    .
    http://yoursite.com/yourservice/dataxml?fisrtid=1000 (lastid=1200)
    http://yoursite.com/yourservice/dataxml?fisrtid=1200 (lastid=1200 not greater than 1200 or -1, data is out of range) 

A sample of GEOWM.INPUTXML for banks and payment systems, accepting rubles in cash for depositing to R-purses in WebMoney Transfer:

<?xml version="1.0" encoding="windows-1251"?>
<wmobjects>

	<row 
	sid="1000" 
	citid="12918" 
	name="X-System payment terminal" 
	web="http://www.x-system.ru/" 
	email="support@x-system.ru"
	mid="117" 
	addr="11-28 Kvesisskaya str." 
	srok="immediately" 
	tarif="2.5% from transaction sum" 
	worktime="24 hours" 
	help="http://www.webmoney.ru/wmintrans6.shtml" 
	dopinfo="Adding funds to R-purse by depositing cash" 
	direction="1" 
	type="7"/>
	
	<row 
	sid="1001" 
	citid="28610" 
	name="X-System payment terminal"  
	web="http://www.x-system.ru/"  
	email="support@x-system.ru" 
	mid="1001" 
	addr="2-23 Kolontai str" 
	srok="immediately" 
	tarif="2.5% from transaction sum" 
	worktime="24 hours" 
	help="http://www.webmoney.ru/wmintrans6.shtml" 
	dopinfo="Adding funds to R-purse by depositing cash"  
	direction="1" 
	type="7"/>
	
        .
        .
        .

	<row 
	sid="1200"
	citid="12918" 
	name="X-System payment terminal" 
	web="http://www.x-system.ru/" 
	email="support@x-system.ru" 
	mid="13" 
	addr="22, Rimsky-Korsakov str" 
	srok="from 9-00 till 22-00" 
	tarif="2.5% from transaction sum" 
	worktime="24 hours" 
	help="http://www.webmoney.ru/wmintrans6.shtml" 
	dopinfo="Adding funds to R-purse by depositing cash"  
	direction="1" 
	type="7"/>

        <lastid value="-1" />
        <!-- end of data -->
			
</wmobjects>

GEOWM.OUTPUTXML web-service

This interface allows retrieving from geodata database:

• List of countries
• List of regions (for a specific country)
• City list (for a specific region)
• List of metro stations (for Moscow and St. Petersbourgh)

Web-service URL and available methods:

https://geo.webmoney.ru/find/GeoSearchService.asmx

Main methods

• GetCountryList
  Returns the list of countries
• GetRegionList
  Returns the list of regions. Counry ID is set.
• GetCityList
  Returns the list of cities and towns. Region ID is set. If hasCoords=1 geographical coordinates are returned, if hasCoords=0 – then not.
• GetNearestMetro
  Returns the list of metro stations, sorted by remoteness from the specified coordinates. Geo-coordinates are set.
• GetNearestMetro2
  Returns the list of metro stations, sorted by remoteness from the address. City ID and address are specified.
• GetNearestMetro3
  Returns the list of metro stations, sorted by remoteness from the address. City ID and address are specified. The city is set as a string, not as ID.

Additional methods

• AddressGeoCoding
  Geocodes the address, by processing it with the ParseAddress method in advance. Returns geographical coordinates. It is similar to GeoCoding, but it is advised to user AddressGeoCoding, if the address is not structured.
• AddressGeoCoding2
  Geocodes the address, by processing it with the ParseAddress method in advance. Returns geographical coordinates. It is similar to GeoCoding, but it is advised to user AddressGeoCoding, if the address is not structured.
• AddressGeoCodingY
  Geocodes the address, by processing it with Yandex geocoder. Returns geographical coordinates. Address contains structured address.
• AddressGeoCodingY2
  Geocodes the address, by processing it with Yandex geocoder. Returns geographical coordinates. Address contains structured address. City is set as a string, and not as ID
• AddressParsingY
  Structures the address with Yandex geocoder. Returns structured address.
• AddressParsingY2
  Structures the address with Yandex geocoder. Returns structured address. The city is specified as a string, not as ID.

In order to user the service, the user must go through the registration procedure. After the registration process you will GUID (unique user’s identifier) and password. Each method of this web-service accepts two additional parameters – GUID and password.

You can find more detailed information on this page offering help for a user of this interface.

GEOWM-Locator search interface

This interface allows making geographical binding of any resources (offices and subsidiaries, objects of storage or agent network, etc), i.e. everything that can be later displayed on a map. The main task of this interface is provide access to unique for WebMoney Transfer system geodata database, and by using which it is possible to display “geographically binded” objects by means of WebMoney GeoService without earlier processing.

You can find more detailed information on page with help services of this service.

Category: XML-Interfaces

This article in other languages: Русский