Static API

Static API позволяет получать статическое изображение карты для использования в HTML-странице или на мобильном устройстве, не прибегая к программированию или использованию динамической загрузки страниц.

Изображение получается в ответ на HTTP запрос GET в формате PNG. В URL запроса можно указывать размер изображения, фрагмент карты, маркеры, ID объектов, которые должны быть отображены на карте.

Схема запроса

http[s]://api.visicom.ua/static-api/1.0/[lang]/image/[map].png?[size|s][&center|c][&zoom|z][&m1..&m8][&style]

Для отображения объектов Data API авторизация не требуется, но мы можем изменить это в будущем.

Параметры запроса

Параметр Описание
lang Язык отображаемых объектов Data API, если нужно изменить
язык надписей карты используйте style
map Имя набора данных. Подробнее см. Visicom Tiles.
size|s Размер картинки в пикселях не более 1024х1024.
center|c Точка центра карты lng,lat.
zoom|z Масштаб отображаемой карты, если отсутствует вычисляется автоматически.
m1..m8 Координаты меток или ID объектов, для многих объектов нужна авторизация.
style Имя стиля оображения. Подробнее см. Visicom Tiles.

Примеры

1. Если заранее известен фрагмент карты, его центр и масштаб, то карту можно получить задав параметры.

FreeMarker template error!


Expression staticapi_url is undefined on line 73, column 21 in reference/staticapi.ftl.
The problematic instruction:
----------
==> ${staticapi_url} [on line 73, column 19 in reference/staticapi.ftl]
----------

Java backtrace for programmers:
----------
freemarker.core.InvalidReferenceException: Expression staticapi_url is undefined on line 73, column 21 in reference/staticapi.ftl.
	at freemarker.core.TemplateObject.assertNonNull(TemplateObject.java:124)
	at freemarker.core.Expression.getStringValue(Expression.java:118)
	at freemarker.core.Expression.getStringValue(Expression.java:93)
	at freemarker.core.DollarVariable.accept(DollarVariable.java:76)
	at freemarker.core.Environment.visit(Environment.java:208)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:208)
	at freemarker.core.Environment.renderElementToString(Environment.java:1563)
	at freemarker.core.StringLiteral.getStringValue(StringLiteral.java:95)
	at freemarker.core.StringLiteral._getAsTemplateModel(StringLiteral.java:80)
	at freemarker.core.Expression.getAsTemplateModel(Expression.java:89)
	at freemarker.core.Assignment.accept(Assignment.java:90)
	at freemarker.core.Environment.visit(Environment.java:208)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:208)
	at freemarker.core.Environment.process(Environment.java:188)
	at freemarker.template.Template.process(Template.java:232)
	at ua.visicom.easyrest.render.FreemarkerLayoutEngine.doRender(Unknown Source)
	at ua.visicom.easyrest.render.FreemarkerLayoutEngine.render(Unknown Source)
	at ua.visicom.easyrest.render.FreemarkerLayoutEngine$YieldDirective2.execute(Unknown Source)
	at freemarker.core.Environment.visit(Environment.java:261)
	at freemarker.core.UnifiedCall.accept(UnifiedCall.java:126)
	at freemarker.core.Environment.visit(Environment.java:208)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:208)
	at freemarker.core.Environment.process(Environment.java:188)
	at freemarker.template.Template.process(Template.java:232)
	at ua.visicom.easyrest.render.FreemarkerLayoutEngine.doRender(Unknown Source)
	at ua.visicom.easyrest.render.FreemarkerLayoutEngine.render(Unknown Source)
	at ua.visicom.easyrest.render.RendererManager$1.next(Unknown Source)
	at ua.visicom.easyrest.render.JsonEngine.render(Unknown Source)
	at ua.visicom.easyrest.render.RendererManager$1.next(Unknown Source)
	at ua.visicom.easyrest.render.CsvEngine.render(Unknown Source)
	at ua.visicom.easyrest.render.RendererManager$1.next(Unknown Source)
	at ua.visicom.easyrest.render.FreemarkerSimpleEngine.render(Unknown Source)
	at ua.visicom.easyrest.render.RendererManager$1.next(Unknown Source)
	at ua.visicom.easyrest.render.RendererManager.render(Unknown Source)
	at ua.visicom.easyrest.Dispatcher.processWebRequest(Unknown Source)
	at ua.visicom.easyrest.RestfulDispatcherServlet.service(Unknown Source)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:198)
	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:96)
	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:496)
	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:140)
	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:81)
	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:87)
	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:342)
	at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:803)
	at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:66)
	at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:790)
	at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1459)
	at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
	at java.lang.Thread.run(Thread.java:745)
Expression staticapi_url is undefined on line 73, column 21 in reference/staticapi.ftl.