Создание простейшего HTTP-сервиса для публикации векторных данных - История изменений

Александр Мурый в 12:25, 18 июня 2013

2013-06-18T12:25:54Z

← Предыдущая версия		Версия от 14:25, 18 июня 2013
Строка 1:		Строка 1:
	{{Статья\|~~Черновик~~}}		{{Статья\|Опубликована\|http-publish-vector}}
	{{Аннотация\|В статье представлен простейший вариант реализации HTTP-сервиса, позволяющий клиенту запрашивать данные на определенный охват в указанной системе координат, некий упрощенный вариант запроса GetFeature, определенного в рамках OGC Web Feature Service.}}		{{Аннотация\|В статье представлен простейший вариант реализации HTTP-сервиса, позволяющий клиенту запрашивать данные на определенный охват в указанной системе координат, некий упрощенный вариант запроса GetFeature, определенного в рамках OGC Web Feature Service.}}

Denis Rykov в 02:20, 15 июня 2013

2013-06-15T02:20:38Z

← Предыдущая версия		Версия от 04:20, 15 июня 2013
Строка 35:		Строка 35:
	Если вам требуется разработать полнофункциональный HTTP-сервис, то, чтобы не изобретать велосипед, можно взять готовое описание какого-нибудь		Если вам требуется разработать полнофункциональный HTTP-сервис, то, чтобы не изобретать велосипед, можно взять готовое описание какого-нибудь
	API (в зависимости от задач) и реализовать его. Например,		API (в зависимости от задач) и реализовать его. Например,
	[http://trac.mapfish.org/trac/mapfish/wiki/MapFishProtocol MapFish Protocol] или [http://resources.arcgis.com/en/help/rest/apiref/index.html?featureserver.html ArcGIS Server REST API] (открытая реализация HTTP-сервиса, реализующая данный API уже [http://gis-lab.info/qa/mapfeatureserver.html существует]).		[http://trac.mapfish.org/trac/mapfish/wiki/MapFishProtocol MapFish Protocol] (реализован в [https://papyrus.readthedocs.org/en/latest/ Papyrus]) или [http://resources.arcgis.com/en/help/rest/apiref/index.html?featureserver.html ArcGIS Server REST API] (открытая реализация HTTP-сервиса, реализующая данный API уже [http://gis-lab.info/qa/mapfeatureserver.html существует]).

	В нашем случае мы разработаем HTTP-сервис, поддерживающий 3 GET-параметра:		В нашем случае мы разработаем HTTP-сервис, поддерживающий 3 GET-параметра:

Denis Rykov в 23:57, 14 июня 2013

2013-06-14T23:57:01Z

← Предыдущая версия		Версия от 01:57, 15 июня 2013
Строка 27:		Строка 27:

	Как показывает практика, для разработки небольших картографических Веб-приложений функционал, предлагаемый спецификацией WFS, крайне избыточен. Зачастую оказывается ненужным ни отображение данных в настольных ГИС, ни гибкий язык описания фильтров, поэтому в большинстве случаев достаточно написания собственного простейшего HTTP-сервиса, возвращающего данные в каком-нибудь стандартном формате (например,[http://gis-lab.info/docs/geojson_ru.html GeoJSON]). Именно решению данной		Как показывает практика, для разработки небольших картографических Веб-приложений функционал, предлагаемый спецификацией WFS, крайне избыточен. Зачастую оказывается ненужным ни отображение данных в настольных ГИС, ни гибкий язык описания фильтров, поэтому в большинстве случаев достаточно написания собственного простейшего HTTP-сервиса, возвращающего данные в каком-нибудь стандартном формате (например,[http://gis-lab.info/docs/geojson_ru.html GeoJSON]). Именно решению данной
	задачи и будет посвящена оставшаяся часть статьи. В качестве примера использования подобного сервиса может служить проект [http://demo.nextgis.ru/openpolice/ Найди участкового], откройте консоль вашего браузера и посмотрите какие запросы уходят на сервер при сдвиге карты.		задачи и будет посвящена оставшаяся часть статьи. В качестве примера использования подобного сервиса может служить проект [http://demo.nextgis.ru/openpolice/ Найди участкового], откройте консоль вашего браузера и посмотрите, какие запросы уходят на сервер и какие ответы приходят от него при сдвиге карты. По виду URL мы можем однозначно сказать, что клиент и сервер взаимодействуют друг с другом, не используя протокол WFS, вместо этого используется некий самописный HTTP-сервис со своим API.

	В качестве языка программирования будем использовать Python, операционная система - Debian GNU/Linux 7.0.		В качестве языка программирования будем использовать Python, операционная система - Debian GNU/Linux 7.0.

Максим Дубинин: /* Введение */

2013-06-14T18:14:46Z

Введение

← Предыдущая версия		Версия от 20:14, 14 июня 2013
Строка 17:		Строка 17:
	WFS-функционал непосредственно в наше приложение. Как поступить в этом случае? Вариантов на самом деле не много: либо найти необходимую библиотеку на том языке		WFS-функционал непосредственно в наше приложение. Как поступить в этом случае? Вариантов на самом деле не много: либо найти необходимую библиотеку на том языке
	программирования, на котором ведется разработка, либо каким-то образом "прикрутить" имеющийся WFS-сервер к нашему приложению. Не беремся утверждать за другие языки		программирования, на котором ведется разработка, либо каким-то образом "прикрутить" имеющийся WFS-сервер к нашему приложению. Не беремся утверждать за другие языки
	программирования, но, например, в случае Python не существует нативных библиотек, реализующих функционал WFS-сервиса, только лишь ~~баиндинги~~ к		программирования, но, например, в случае Python не существует нативных библиотек, реализующих функционал WFS-сервиса, только лишь обертки к [http://mapserver.org/mapscript/introduction.html mapscript], а это по сути сводится к установке библиотек MapServer (который написан на C/C++). Завязывание же своего приложения на внешний по отношению к нему WFS-сервер - задача непростая и тянущая за собой ряд очень серьезных проблем:
	[http://mapserver.org/mapscript/introduction.html mapscript], а это по сути сводится к установке библиотек MapServer (который написан на C/C++). Завязывание
	же своего приложения на внешний по отношению к нему WFS-сервер - задача непростая и тянущая за собой ряд очень серьезных проблем:

	* необходимость подготовки дистрибутива WFS-сервера под целевую платформу;		* необходимость подготовки дистрибутива WFS-сервера под целевую платформу;

Denis Rykov: /* Визуализация данных в OpenLayers */

2013-06-14T04:29:06Z

Визуализация данных в OpenLayers

← Предыдущая версия		Версия от 06:29, 14 июня 2013
Строка 386:		Строка 386:
	strategies: [new OpenLayers.Strategy.BBOX({ratio: 1, resFactor: 1})],		strategies: [new OpenLayers.Strategy.BBOX({ratio: 1, resFactor: 1})],
	protocol: new OpenLayers.Protocol.HTTP({		protocol: new OpenLayers.Protocol.HTTP({
	url: "http://~~debian~~:8087/features",		url: "http://localhost:8087/features",
	params: {		params: {
	attrs: 'id,name',		attrs: 'id,name',
Строка 409:		Строка 409:
	[[Файл:Geoservice.png\|581px\|thumb\|center\|<center>Результат визуализации данных HTTP-сервиса в OpenLayers</center>]]		[[Файл:Geoservice.png\|581px\|thumb\|center\|<center>Результат визуализации данных HTTP-сервиса в OpenLayers</center>]]

	Если ~~вы откроете~~ консоль ~~вашего~~ Веб-браузера и ~~введете~~ следующие команды:		Если открыть консоль Веб-браузера и ввести следующие команды:

	<pre>		<pre>
	geodetdom.features.length		geodetdom.features.length
			100
	geodetdom.features[1].attributes		geodetdom.features[1].attributes
			Object {id: 8547, name: "Школа-интернат № 1 "}
	</pre>		</pre>

	то ~~увидите~~, что количество объектов слоя не превосходит лимита, заданного на уровне сервиса (100 объектов), а также что, объекты содержат только запрошенные атрибуты.		то можно увидеть, что количество объектов слоя не превосходит лимита, заданного на уровне сервиса (100 объектов), а также что, объекты содержат только запрошенные атрибуты.

	== Заключение ==		== Заключение ==

	Таким образом, мы создали простейший HTTP-сервис, который на входе принимает определенный набор параметров и возвращает результат в формате GeoJSON. И хотя это всего-лишь учебный вариант, в котором не предусмотрена никакая обработка ошибок, но он наглядно показывает как может быть устроен простейший сервис подобного типа. Данные, предоставляемые этим сервисом, легко могут быть визуализированы с помощью картографического JavaScript-клиента, например, OpenLayers.		Таким образом, мы создали простейший HTTP-сервис, который на входе принимает определенный набор параметров и возвращает результат в формате GeoJSON. И хотя это всего-лишь учебный вариант, в котором не предусмотрена никакая обработка ошибок, но он наглядно показывает как может быть устроен простейший сервис подобного типа. Данные, предоставляемые этим сервисом, легко могут быть визуализированы с помощью картографического JavaScript-клиента, например, OpenLayers.

Denis Rykov: /* Визуализация данных в OpenLayers */

2013-06-14T04:27:02Z

Визуализация данных в OpenLayers

← Предыдущая версия		Версия от 06:27, 14 июня 2013
Строка 405:		Строка 405:
	</syntaxhighlight>		</syntaxhighlight>

	В данном примере использована стратегия [http://dev.openlayers.org/releases/OpenLayers-2.12/doc/devdocs/files/OpenLayers/Strategy/BBOX-js.html OpenLayers.Strategy.BBOX], что означает, что данные будут запрашиваться при каждом изменении охвата карты. Опция resFactor, выставленная в значение 1 позволяет нам запрашивать данные даже в том случае, если новый охват попадает в предыдущий (например, при изменении масштаба карты), но с учетом того, что изменилось разрешение базового слоя. Стратегия BBOX автоматически создает фильтр слоя OpenLayers.Filter.Spatial.BBOX, что приводит к тому, что при запросе данных к URL автоматически добавляется GET-параметр bbox с указанием значения текущего охвата, что совпадает с именем GET-параметра, ответственного за охват, используемого в нашем сервисе.		В данном примере использована стратегия [http://dev.openlayers.org/releases/OpenLayers-2.12/doc/devdocs/files/OpenLayers/Strategy/BBOX-js.html OpenLayers.Strategy.BBOX], что означает, что данные будут запрашиваться при каждом изменении охвата карты. Опция resFactor, выставленная в значение 1, позволяет нам запрашивать данные даже в том случае, если новый охват попадает в предыдущий (например, при изменении масштаба карты), но с учетом того, что изменилось разрешение базового слоя. Стратегия BBOX автоматически создает фильтр слоя OpenLayers.Filter.Spatial.BBOX, что приводит к тому, что при запросе данных к URL автоматически добавляется GET-параметр bbox с указанием значения текущего охвата, что совпадает с именем GET-параметра, ответственного за охват, используемого в нашем сервисе.

	[[Файл:Geoservice.png\|581px\|thumb\|center\|<center>Результат визуализации данных HTTP-сервиса в OpenLayers</center>]]		[[Файл:Geoservice.png\|581px\|thumb\|center\|<center>Результат визуализации данных HTTP-сервиса в OpenLayers</center>]]

Denis Rykov: /* Визуализация данных в OpenLayers */

2013-06-14T04:26:01Z

Визуализация данных в OpenLayers

@@ Строка 363: / Строка 363: @@
 touch client.html
 </pre>
 == Заключение ==
 Таким образом, мы создали простейший HTTP-сервис, который на входе принимает определенный набор параметров и возвращает результат в формате GeoJSON. И хотя это всего-лишь учебный вариант, в котором не предусмотрена никакая обработка ошибок, но он наглядно показывает как может быть устроен простейший сервис подобного типа. Данные, предоставляемые этим сервисом, легко могут быть визуализированы с помощью картографического JavaScript-клиента, например, OpenLayers.

Denis Rykov в 04:05, 14 июня 2013

2013-06-14T04:05:43Z

@@ Строка 130: / Строка 130: @@
 import json
 import bottle_pgsql
-from bottle import install, route, response, request, run
+from bottle import install, route, response, request, run, static_file
 from yaml import load
@@ Строка 343: / Строка 343: @@
 Для представления JSON-данных в удобочитаемом варианте можно воспользоватся сервисом [http://jsonlint.com/ JSONLint], что мы собственно и сделали.
 == Заключение ==
 Таким образом, мы создали простейший HTTP-сервис, который на входе принимает определенный набор параметров и возвращает результат в формате GeoJSON. И хотя это всего-лишь учебный вариант, в котором не предусмотрена никакая обработка ошибок, но он наглядно показывает как может быть устроен простейший сервис подобного типа. Данные, предоставляемые этим сервисом, легко могут быть визуализированы с помощью картографического JavaScript-клиента, например, OpenLayers.

Denis Rykov в 02:24, 14 июня 2013

2013-06-14T02:24:57Z

← Предыдущая версия		Версия от 04:24, 14 июня 2013
Строка 90:		Строка 90:
	<pre>pip install bottle-pgsql</pre>		<pre>pip install bottle-pgsql</pre>

	[https://~~pypi~~.~~python.org~~/~~pypi~~/bottle-pgsql~~/0.1~~ bottle-pgsql] - это плагин, автоматизирующий работу с PostgreSQL в Bottle-приложение. При каждом запросе он автоматически		[https://github.com/raisoblast/bottle-pgsql bottle-pgsql] - это плагин, автоматизирующий работу с PostgreSQL в Bottle-приложение. При каждом запросе он автоматически
	подключается к базе данных, передаёт в функцию обработки запроса ее дескриптор и в самом конце закрывает соединение. Результаты выполнения запросов представляются в виде словарей, а не в виде кортежей, как это происходит по умолчанию в psycopg2.		подключается к базе данных, передаёт в функцию обработки запроса ее дескриптор и в самом конце закрывает соединение. Результаты выполнения запросов представляются в виде словарей, а не в виде кортежей, как это происходит по умолчанию в psycopg2.

Denis Rykov в 02:21, 14 июня 2013

2013-06-14T02:21:33Z

← Предыдущая версия		Версия от 04:21, 14 июня 2013
Строка 150:		Строка 150:
	</syntaxhighlight>		</syntaxhighlight>

	И ~~подключаемся~~ плагин bottle-pgsql:		И подключаем плагин bottle-pgsql:

	<syntaxhighlight lang="python">		<syntaxhighlight lang="python">
Строка 164:		Строка 164:
	@route('/features')		@route('/features')
	def geoservice(db, bbox='-180,-90,180,90', epsg='4326', limit='100'):		def geoservice(db, bbox='-180,-90,180,90', epsg='4326', limit='100'):
			# Параметры запроса
	bbox = (request.GET.get('bbox') or bbox).split(',')		bbox = (request.GET.get('bbox') or bbox).split(',')
	epsg = request.GET.get('epsg') or epsg		epsg = request.GET.get('epsg') or epsg
Строка 172:		Строка 172:
	table = db_config.get('table')		table = db_config.get('table')

			# Строка запроса
	query = """select st_asgeojson(st_transform({gc}, {epsg})) as g, *		query = """select st_asgeojson(st_transform({gc}, {epsg})) as g, *
	from {table}		from {table}
Строка 178:		Строка 179:
	""".format(gc=geometry_column, epsg=epsg, table=table, limit=limit, **coordinates)		""".format(gc=geometry_column, epsg=epsg, table=table, limit=limit, **coordinates)

			# Выполнение запроса
	db.execute(query)		db.execute(query)
	records = db.fetchall()		records = db.fetchall()

			# Формируем GeoJSON вручную
	collection = {'type': 'FeatureCollection', 'features': []}		collection = {'type': 'FeatureCollection', 'features': []}
	for rec in records:		for rec in records:
Строка 187:		Строка 190:
	feature['properties'] = dict()		feature['properties'] = dict()

			# Итерация по именам полей
	for colname in rec.keys():		for colname in rec.keys():
	if colname == 'g':		if colname == 'g':