Плагин Qt Location Esri
Обзор
Этот плагин геосервисов позволяет приложениям получать доступ к службам местоположения Esri с использованием API Qt Location. Использование этих служб регулируется условиями использования Esri.
Данные предоставляются многими поставщиками контента.
Плагин геосервисов Esri можно загрузить, используя ключ плагина «esri».
Вы можете использовать службы, предоставляемые ArcGIS Platform компании Esri, подписавшись на программу ArcGIS Developer Program бесплатно. Подробности плана «Essentials» см. здесь: {https://developers.arcgis.com/pricing/}{Стоимость программы ArcGIS Developer Program}.
Подписка Developer предоставляет бесплатный вариант для разработки и тестирования приложений. С её помощью ваши приложения могут быть выпущены в производство при следующих условиях:
- Приложение может запросить до одного миллиона карт в месяц.
- Подписка Developer включает 50 кредитов. Стоимость 40 кредитов составляет 1000 геокодирований, а 0,5 кредита требуется для каждой сгенерированной маршрутизации. Поиск по местам бесплатный.
- Приложение не генерирует доходы напрямую. То есть конечные пользователи должны иметь возможность получить и использовать его бесплатно.
Если вышеуказанные условия не могут быть выполнены, подписка ArcGIS Online — правильный выбор, так как она предоставляет приложениям полный доступ к платформе ArcGIS.
Параметры
Обязательные параметры
| Параметр | Описание |
|---|---|
| esri.token | Токен безопасности для использования только служб маршрутизации. Для служб картографирования, геокодирования и поиска по местам токен не требуется. |
Для использования служб маршрутизации, размещённых в ArcGIS Online с плагином Esri, требуется токен. Вы можете получить токен для целей тестирования, или вы можете подписаться на подписку ArcGIS Online.
Дополнительные параметры
| Параметр | Описание |
|---|---|
| esri.useragent | Строка пользовательского агента, отправленная при выполнении сетевых запросов |
| esri.mapping.minimumZoomLevel | Минимальный уровень масштабирования [вещественное число], при котором отображается карта |
| esri.mapping.maximumZoomLevel | Максимальный уровень [вещественное число] отображения карты |
| esri.mapping.cache.directory | Абсолютный путь к каталогу кэша тайлов карты, используемому в качестве кэша сетевого диска. По умолчанию кэш размещается в подкаталоге |
| esri.mapping.cache.disk.cost_strategy | Стратегия расчёта стоимости для кеширования тайлов карты на диске. Допустимые значения: bytesize и unitary. Использование bytesize означает, что связанный параметр размера (esri.mapping.cache.disk.size) будет интерпретироваться как байты. Использование unitary означает, что они будут интерпретироваться как количество тайлов. Значение по умолчанию для этого параметра — bytesize. |
| esri.mapping.cache.disk.size | Размер кэша на диске для тайлов карты. По умолчанию размер кэша составляет 50 МБ, когда стратегия расчёта стоимости для этого кэша — bytesize, или 1000 тайлов, когда стратегия — unitary. |
| esri.mapping.cache.memory.cost_strategy | Стратегия расчёта стоимости для кеширования тайлов карты в памяти. Допустимые значения: bytesize и unitary. Использование bytesize означает, что связанный параметр размера (esri.mapping.cache.memory.size) будет интерпретироваться как байты. Использование unitary означает, что они будут интерпретироваться как количество тайлов. Значение по умолчанию для этого параметра — bytesize. |
| esri.mapping.cache.memory.size | Размер кэша в памяти для тайлов карты. По умолчанию размер кэша составляет 3 МБ, когда стратегия расчёта стоимости для этого кэша — bytesize, или 100 тайлов, когда стратегия — unitary. |
| esri.mapping.cache.texture.cost_strategy | Стратегия расчёта стоимости для кеширования распакованных тайлов карты в памяти. Допустимые значения: bytesize и unitary. Использование bytesize означает, что связанный параметр размера (esri.mapping.cache.texture.size) будет интерпретироваться как байты. Использование unitary означает, что они будут интерпретироваться как количество тайлов. Значение по умолчанию для этого параметра — bytesize. |
| esri.mapping.cache.texture.size | Размер кэша текстур для тайлов карты. По умолчанию размер кэша составляет 6 МБ, когда стратегия расчёта стоимости для этого кэша — bytesize, или 30 тайлов, когда стратегия — unitary. Обратите внимание, что кэш текстур имеет жёсткий минимальный размер, зависящий от размера области просмотра карты (он должен содержать достаточно данных для отображения тайлов, которые в данный момент видны на экране). Это значение — количество кэша, которое используется дополнительно к минимальному необходимому. |
| esri.mapping.prefetching_style | Этот параметр позволяет указать, как будет выполняться предварительная загрузка тайлов движком. Значение по умолчанию, TwoNeighbourLayers, заставляет движок предварительно загружать тайлы для слоя выше и ниже текущего слоя тайлов, предоставляя готовые тайлы при приближении или отдалении от текущего уровня масштабирования. OneNeighbourLayer предварительно загружает только один слой, наиболее близкий к текущему уровню масштабирования. Наконец, NoPrefetching позволяет отключить предварительную загрузку, так что будут загружаться только видимые тайлы. Обратите внимание, что в зависимости от активного типа карты этот параметр может быть проигнорирован. |
Язык направлений
Служба поддерживает генерацию направлений на следующих языках:
| Язык | Описание |
|---|---|
| ar | Генерация направлений на арабском языке |
| cs | Генерация направлений на чешском языке |
| de | Генерация направлений на немецком языке |
| el | Генерация направлений на греческом языке |
| en | (по умолчанию) Генерация направлений на английском языке |
| es | Генерация направлений на испанском языке |
| et | Генерация направлений на эстонском языке |
| fr | Генерация направлений на французском языке |
| he | Генерация направлений на иврите |
| it | Генерация направлений на итальянском языке |
| ja | Генерация направлений на японском языке |
| ko | Генерация направлений на корейском языке |
| lt | Генерация направлений на литовском языке |
| lv | Генерация направлений на латышском языке |
| nl | Генерация направлений на голландском языке |
| pl | Генерация направлений на польском языке |
| pt-BR | Генерация направлений на бразильском португальском языке |
| pt-PT | Генерация направлений на португальском языке (Португалия) |
| ru | Генерация направлений на русском языке |
| sv | Генерация направлений на шведском языке |
| tr | Генерация направлений на турецком языке |
| zh-CN | Упрощённый китайский |
Если указаны только коды недоступных языков через свойство locales, служба возвращает направления на языке по умолчанию — английском.
Единицы измерения расстояний в направлениях
QLocale::MetricSystem (по умолчанию) используют метры, другие значения (QLocale::ImperialUSSystem, QLocale::ImperialUSSystem) используют футы.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/location-plugin-esri.html
