Интерфейсы сервиса Geo WebMoney

Сервис GEOWM.INPUTXML

Данный интерфейс позволяет производить автоматическую загрузку на сервер WebMoney GeoService списка пользовательских WM-объектов определенного типа.

Формат файла XML для сервиса GEOWM.INPUTXML:

Ниже приведен пример, описывающий один пользовательский объект (обменный пункт)

<?xml version="1.0" encoding="windows-1251"?>
<wmobjects>
 <row 
  sid="34" 
  citid="12918" 
  name="Обменный пункт WM-USD (через банковскую ячейку)" 
  wmid="254923317046" 
  web="http://www.wmcasher.com"
  email="cash@wmcasher.com" 
  type="1" 
  addr="ул. Орджоникидзе д.9 корп.2" 
  worktime="Понедельник - пятница, с 11:00 до 17:00" 
  phone="(смотрите на сайте)" 
  mid="69" 
  mid2="158" 
  dopinfo="Обмен WM на наличные USD и наоборот через банковскую ячейку. Ввод - 0%, вывод - 2%"
  help="http://www.wmcasher.com/contact.asp" 
  lng="37.5998"
  lat="55.70924" 
  direction="3" 
  lang="ru-RU"
  />
</wmobjects>

Требования к файлу GEOWM.INPUTXML:

• Файл должен начинаться открывающим тэгом <wmobjects> и заканчиваться тэгом </wmobjects>
• Содержать хотя бы один тег <row /> – строка, содержащая данные об одном объекте
• Файл должен быть сохранен в кодировке windows-1251
• Все объекты должны быть географически привязаны к базе данных WebMoney GeoService, т.е. каждому объекту должен быть сопоставлен уникальный номер (ID) населенного пункта, в котором он расположен. Как получить список стран, регионов и городов, читайте ниже по тексту.
• Ко всем данным должно применяться маскирование запрещенных символов:
• Двойные кавычки «"» должны быть замены на &quot;
• Знак Больше «>» должен быть заменен на &gt;
• Знак Меньше «<» должен быть заменен на &lt;

Каждый пакет XML не должен превышать 200 (максимальное число строк) строк в одном наборе данных. Для обновления данных, где количество строк больше чем 200, сервис обновления сайта вызывает зарегистрированный URL несколько раз, с различными параметрами FirstId, который указывает на максимальный SID предыдущего набора данных. Для корректной работы системы обновления в каждом пакете данных (оптимально использовать не более 200 строк) необходимо указывать тег LastID. LastID – это максимальный SID (идентификатор точки) в одном наборе данных.

Формат описан ниже:

    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 или -1, данные кончились) 

Пример GEOWM.INPUTXML для банков и платежных систем, принимающих наличные рубли для пополнения R-кошельков системы WebMoney Transfer:

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

	<row 
	sid="1000" 
	citid="12918" 
	name="Платежный терминал X-System" 
	web="http://www.x-system.ru/" 
	email="support@x-system.ru"
	mid="117" 
	addr="ул. Квесисская, д. 28, стр. 11." 
	srok="мгновенно" 
	tarif="2.5% от суммы платежа" 
	worktime="круглосуточно" 
	help="http://www.webmoney.ru/wmintrans6.shtml" 
	dopinfo="Пополнение R кошелька наличными рублями" 
	direction="1" 
	type="7"/>
	
	<row 
	sid="1001" 
	citid="28610" 
	name="Платежный терминал X-System"  
	web="http://www.x-system.ru/"  
	email="support@x-system.ru" 
	mid="1001" 
	addr="ул. Коллонтай, д. 23, стр. 2." 
	srok="мгновенно" 
	tarif="2.5% от суммы платежа" 
	worktime="круглосуточно" 
	help="http://www.webmoney.ru/wmintrans6.shtml" 
	dopinfo="Пополнение R кошелька наличными рублями"  
	direction="1" 
	type="7"/>
	
        .
        .
        .

	<row 
	sid="1200"
	citid="12918" 
	name="Платежный терминал X-System" 
	web="http://www.x-system.ru/" 
	email="support@x-system.ru" 
	mid="13" 
	addr="ул. Римского-Корсакова, д. 22" 
	srok="с 9-00 до 22-00" 
	tarif="2.5% от суммы платежа" 
	worktime="круглосуточно" 
	help="http://www.webmoney.ru/wmintrans6.shtml" 
	dopinfo="Пополнение R кошелька наличными рублями"  
	direction="1" 
	type="7"/>

        <lastid value="-1" />
        <!-- конец данных -->
			
</wmobjects>

Веб-сервис GEOWM.OUTPUTXML

Данный интерфейс позволяет получить из базы геоданных:

• список стран
• список регионов (для конкретной страны)
• список городов (для конкретного региона)
• список станций метро (для Москвы и Санкт-Петербурга)

URL веб-сервиса и доступные методы:

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

Основные методы

• GetCountryList
  Возвращает список стран
• GetRegionList
  Возвращает список регионов. Задается идентификатор страны.
• GetCityList
  Возвращает список городов и населенных пунктов. Задается идентификатор региона. При hasCoords=1 выдаются геогр.координаты, если hasCoords=0 не выдаются
• GetNearestMetro
  Возвращает список станций метро, отсортированный по удаленности от заданных координат. Задаются гео-координаты.
• GetNearestMetro2
  Возвращает список станций метро, отсортированный по удаленности от адреса. Задаются идентификатор города и адрес.
• GetNearestMetro3
  Возвращает список станций метро, отсортированный по удаленности от адреса. Задаются название города и адрес. Город задается строкой, а не ID

Дополнительные методы

• AddressGeoCoding
  Геокодирует адрес, предварительно обработав методом ParseAddress. Возвращает географические координаты. Эквивалент GeoCoding, желательно использовать AddressGeoCoding, если адрес не структурирован.
• AddressGeoCoding2
  Геокодирует адрес, предварительно обработав методом ParseAddress. Возвращает географические координаты. Эквивалент GeoCoding, желательно использовать AddressGeoCoding, если адрес не структурирован.
• AddressGeoCodingY
  Геокодирует адрес. Возвращает географические координаты. address содержит структурированный адрес
• AddressGeoCodingY2
  Геокодирует адрес. Возвращает географические координаты. address содержит структурированный адрес. Город задается строкой, а не ID
• AddressParsingY
  Структурирует адрес. Возвращает структурированный адрес
• AddressParsingY2
  Структурирует адрес. Возвращает структурированный адрес. Город задается строкой, а не ID

Для использования сервиса необходимо пройти процедуру регистрации. После регистриации вы получите GUID (уникальный идентификатор участника) и пароль. Каждый метод веб-сервиса принимает два дополнительных параметра: GUID и пароль.

Более подробную информацию Вы можете узнать на странице помощи данного сервиса.

Поисковый интерфейс GEOWM-Locator

Данный интерфейс позволяет производить географическую привязку любых ресурсов (офисов и представительств компании, объектов складской или агентской сети и др.), т.е., всего, что может быть впоследствии отображено на карте. Главная задача интерфейса – предоставление доступа к единой для системы WebMoney Transfer базе геоданных, при использовании которой возможно отображение “географически привязанных” объектов средствами WebMoney GeoService без дополнительной обработки.

Более подробную информацию Вы можете узнать на странице помощи данного сервиса.

This article in other languages: English