Операция

Возвращает точечные геометрии для адресов в таблице, то есть выполняет геокодирование. Укажите либо строку адреса в свойстве Search Text, либо структурированные части в соответствующих свойствах, таких как Country, Street и т. д. Также допускаются комбинации. Для этой операции требуется специальная лицензия. Адреса, которые по какой-либо причине не удалось найти, не возвращаются в результате.

Функциональность, предлагаемая Qlik Geocoding (через AddressPointLookup и PointToAddressLookup), отличается от других характеристик поиска местоположения. Qlik Geocoding позволяет выполнять поиск на уровне адреса, тогда как обычный поиск местоположения может быть точным только до уровня почтового индекса.

При начале работы с Qlik Geocoding используйте шаблон, указанный в разделе Настройка Qlik Geocoding (только английский язык).

Большинство параметров представлены в двух версиях: одна указывает фактическое значение, например country="SWE", а другая указывает имя поля, из которого должно быть получено фактическое значение, например countryField="CountryIso2".

Возвращает следующие столбцы:

• <dataset key column> - Ключевое поле из входного набора данных.
• Address - Найденный адрес, отформатированный в соответствии со стандартами адресов страны.
• Geometry - Точка для найденного элемента.
• HouseNumber - Номер дома для найденного элемента.
• Street - Улица для найденного элемента.
• PostalCode - Почтовый индекс для найденного элемента.
• City - Название административного деления уровня города для найденного элемента.
• Adm1 - Название или сокращенное название административного деления первого порядка (штат/область) для найденного элемента.
• CountryIso2 - Код страны для найденного элемента.
• Match - Значение от 0 до 1, показывающее, насколько хорошим было совпадение. Значение 1 означает идеальное совпадение.
• Все столбцы, кроме ключевого поля из dataset, с префиксом имени набора данных.

Возвращаемые поля могут быть пустыми, если они неприменимы или данные недоступны.

Поддерживает:

• ScriptEval в скриптах загрузки.

Пример, который геокодирует некоторые шведские адреса, где каждый элемент находится в собственном поле:

В этом примере показано геокодирование в стиле свободного текста:

Генерирует прямоугольные или шестиугольные бины для точечного набора данных. Это способ агрегирования точечных данных, чтобы обзор данных мог отображаться эффективно.

Возвращает следующие столбцы:

• <dataset key column> - Ключевое поле из входного набора данных.
• BinId - Идентификатор бина.
• BinTable.BinPolygon - Многоугольник для бина.
• BinTable.CenterPoint - Точка в центре бина.
• Все столбцы, кроме ключевого поля из dataset, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.

Пример, который загружает шестиугольные бины из аэропортов США:

Возвращает отношения и расстояния между объектами в одном наборе данных и ближайшими объектами в другом, если какой-либо из них ближе максимального расстояния. Стоимость также может быть рассчитана вдоль дорог, и в этом случае дополнительно используется время в пути. Эта операция полезна во многих случаях, не только для получения отношений к ближайшим объектам, но и для получения матриц расстояний между набором точек.

Возвращает следующие столбцы:

• <dataset1 name>_<dataset2 name>_RelationId - Ключ, сгенерированный для отношения между двумя геометриями.
• <dataset1 key column> - Ключевое поле из входного набора данных dataset1.
• <dataset2 key column> - Ключевое поле из входного набора данных dataset2.
• Distance - Расстояние в единицах, указанных в costUnit.
• Status - Возвращаемый статус: либо "ok", либо "failed:" с последующим сообщением об ошибке.
• LowResLine - Версия линии маршрута с низким разрешением, доступна только для типов расстояния, отличных от bird.
• Все столбцы, кроме ключевого поля из входного набора данных dataset1, с префиксом имени набора данных.
• Все столбцы, кроме ключевого поля из входного набора данных dataset2, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.

В этом примере находятся ближайшие аэропорты к точкам в таблице:

Создает кластеры из точечного набора данных на основе географической близости между точками. Генерация кластеров управляется параметром distance, который определяет, насколько далеко точка может находиться от кластера, к которому она принадлежит. Возвращает таблицу с отношениями между точками и кластерами. Также возвращает присоединенную таблицу с именем Clusters с геометриями кластеров. Она содержит поля ClusterID, ClusterCenter (точечная геометрия) и PointCount. Поле количества содержит количество точек в кластере.

Возвращает следующие столбцы:

• <dataset key column> - Ключевое поле из входного набора данных.
• ClusterID - Идентификатор кластера, к которому принадлежит точка.
• Clusters.ClusterPoint - Центральная точка кластера.
• Clusters.PointCount - Количество исходных точек, принадлежащих кластеру.
• Все столбцы, кроме ключевого поля из входного набора данных, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.

В этом примере аэропорты в США кластеризуются таким образом, что аэропорты, находящиеся ближе 50 км, принадлежат к одному кластеру:

Растворяет и упрощает области для формирования более крупных областей на основе сопоставления между старыми идентификаторами областей (или геометриями) и новыми идентификаторами областей. Обычно это используется для создания пользовательских областей, которые состоят из более мелких четко определенных областей, таких как почтовые или административные области.

Возвращает следующие столбцы:

• <dissolveField> - Поле, указанное как dissolveField во входных данных.
• DissolvedPolygon - Геометрии новых растворенных областей.

Поддерживает:

• ScriptEval в скриптах загрузки.

Набор данных геометрии не является обязательным. Если он не предоставлен, предполагается, что геометрии доступны в наборе данных определения растворения.

Обратите внимание, что перекрытия многоугольников удаляются во всех разрешениях, кроме Source.

В этом примере создаются два региона: один состоит из CA и AZ, а другой — из WA и OR:

Возвращает таблицу, которая сопоставляет ключ в dataset1 и ключ в dataset2 для всех пересекающихся объектов. Если оба набора данных содержат многоугольники, возвращается относительная площадь перекрытия по сравнению с площадями в соответствующем наборе данных.

Можно ограничить количество пересекающихся геометрий во втором наборе данных, которые должны быть сопоставлены с каждой геометрией в первом наборе данных, указав intersectsCount. Затем наиболее пересекающиеся геометрии возвращаются по порядку. Операция симметрична, если intersectsCount не указан.

Возвращает следующие столбцы:

• <dataset1 name>_<dataset2 name>_RelationId - Ключ, сгенерированный для отношения между двумя геометриями.
• <dataset1 key column> - Ключевое поле из входного набора данных dataset1.
• <dataset2 key column> - Ключевое поле из входного набора данных dataset2.
• <dataset1 name>.RelativeOverlap - Перекрытие по сравнению с многоугольником в dataset1. Возвращается только в том случае, если оба набора данных содержат многоугольники. Запрос этого поля снижает производительность.
• <dataset2 name>.RelativeOverlap - Перекрытие по сравнению с многоугольником в dataset2. Возвращается только в том случае, если оба набора данных содержат многоугольники. Запрос этого поля снижает производительность.
• Все столбцы, кроме ключевого поля из входного набора данных dataset1, с префиксом имени набора данных.
• Все столбцы, кроме ключевого поля из входного набора данных dataset2, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.

В этом примере вычисляется, какие штаты пересекают некоторые линии:

Возвращает информацию о местоположении и точечные геометрии для IP-адресов в таблице. Это полезно при анализе данных доступа к веб-сервисам. Возвращаемая таблица содержит следующие поля:

• Ключевое поле - То же, что и ключевое поле для таблицы имен.
• <Address Table Ip Field> - То же, что и IP-поле, которое искалось. Доступно только в том случае, если оно не совпадает с ключевым полем.
• IpPoint - Точка для найденного элемента.
• CountryIso2 - Код страны для найденного элемента.
• Adm1Code - Код административной области первого порядка для найденного элемента. Обратите внимание, что этот код не всегда совместим с кодом, возвращаемым службой местоположения.
• City - Город для найденного элемента.
• Все столбцы, кроме ключевого поля из входного набора данных, с префиксом имени набора данных.

IP-геолокация по своей природе неточна. Для многих IP-адресов можно точно определить город, но для других можно определить только страну.

Лучшая практика — отправлять в операцию IpLookup только столбец Ip. Пример, который ищет некоторые IP-адреса:

Часто один и тот же IP-адрес повторяется во многих строках. В таком случае для повышения производительности лучше сначала отфильтровать только уникальные IP-адреса, как в этом примере:

Этот продукт включает данные GeoLite2, созданные MaxMind, доступные на MaxMind.

Загружает набор данных без применения каких-либо операций. Это позволяет загружать все форматы, поддерживаемые GeoOperations. Обратите внимание, что Simplify может быть хорошей альтернативой Load, если геометрии детализированы и медленно отображаются.

Возвращает следующие столбцы:

• Все столбцы из dataset.

Поддерживает:

• ScriptEval в скриптах загрузки.

Пример, который загружает почтовые индексы из Швеции:

Поскольку WKT поддерживается в качестве формата геометрии для данных в INTABLE, операция Load отлично подходит для преобразования географических геометрий, загруженных из базы данных, в формат геометрии Sense, чтобы их можно было отобразить. В следующем примере показано, как преобразовать данные WKT, в данном случае из таблицы MyWKTData:

Возвращает ближайший адрес для точек в списке, также известный как обратное геокодирование. Для этой операции требуется специальная лицензия. Точки, расположенные близко к улицам, получат адреса на уровне улиц, в противном случае будет возвращен почтовый район или совпадения на уровне города. Для точек, находящихся слишком далеко, данные не возвращаются.

Возвращает следующие столбцы:

• <dataset key column> - Ключевое поле из входного набора данных.
• Address - Найденный адрес, отформатированный в соответствии со стандартами адресов страны.
• Geometry - Точка для найденного элемента.
• HouseNumber - Номер дома для найденного элемента.
• Street - Улица для найденного элемента.
• PostalCode - Почтовый индекс для найденного элемента.
• City - Название административного деления уровня города для найденного элемента.
• Adm1 - Название или сокращенное название административного деления первого порядка (штат/область) для найденного элемента.
• CountryIso2 - Код страны для найденного элемента.
• Distance - Расстояние в метрах до найденного адреса.
• Все столбцы, кроме ключевого поля из dataset, с префиксом имени набора данных.

Обратите внимание, что возвращаемые поля могут быть пустыми, если они неприменимы или данные недоступны.

Пример, который получает адреса для некоторых точек:

Вычисляет маршруты, включая длину и продолжительность, между двумя местоположениями в таблице.

Обратите внимание, что начальной точкой является столбец геометрии в наборе данных. Столбец пункта назначения указывается в параметрах операции, поскольку наборы данных знают только об одном столбце геометрии.

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

Возвращает следующие столбцы:

• <dataset key column> - Ключевое поле из входного набора данных.
• Distance - Расстояние маршрута в метрах.
• Duration - Расчетное время в пути по маршруту в секундах.
• Status - Возвращаемый статус: либо "ok", либо "failed:" с последующим сообщением об ошибке.
• LowResLine - Версия линии маршрута с низким разрешением.
• Все столбцы, кроме ключевого поля из входного набора данных, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.
• ScriptEvalStr в скриптах диаграмм для получения маршрута.
• ScriptEval в скриптах диаграмм для получения расстояния или продолжительности.

Это пример, который вычисляет маршруты между точками в наборе данных:

Это пример, который вычисляет маршруты непосредственно в слое линий. Операция вызывается для выборки каждый раз при изменении выборки. Обычно должно быть условие вычисления, которое истинно, если выбрано только несколько точек (в противном случае лучше вычислять маршруты в скрипте загрузки). Это следует поместить в скрипт загрузки для загрузки данных. Например:

Используйте следующее измерение в слое линий:

Используйте условие вычисления в слое линий:

В свойстве Местоположение, которое должно быть установлено на Line geometry, поместите это для вычисления маршрутов от фиксированной позиции до выбранных точек:

Упрощает геометрии линий и областей в наборе данных. Часто бывает полезно загружать географические данные с помощью операции Simplify вместо операции Load, чтобы получить более эффективные геометрии, которые отображаются быстрее.

Степень упрощения вычисляется автоматически на основе площади, количества объектов и размера объектов. Затем ее можно настроить на более высокое или более низкое разрешение с помощью параметра resolution.

Упрощение областей выполняется с помощью алгоритма, который обрабатывает топологии и может удалять пробелы и объединять острова.

Упрощение линий выполняется с помощью алгоритма сокращения точек останова.

Обратите внимание, что перекрытия многоугольников удаляются. В выходных данных не будет перекрывающихся многоугольников.

Возвращает следующие столбцы:

• <dataset key column> - Ключевое поле из входного набора данных dataset1.
• Simplified_<geometry column name> - Упрощенные версии исходных геометрий.
• Все столбцы, кроме ключевого поля из dataset, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.

Пример, который загружает упрощенные версии штатов США:

Вычисляет изохронные области времени в пути. Все местоположения в пределах возвращаемой области могут быть достигнуты за определенное время или находятся ближе определенного расстояния по дорогам. Возвращает таблицу с идентификатором, геометрией области поездки, центральной точкой, стоимостью, единицей стоимости и статусом (OK или failed).

Если вы используете "bird" в качестве типа транспорта, он генерирует географически правильные круги вокруг начальных точек.

Возвращает следующие столбцы:

• <dataset key column> - Ключевое поле из входного набора данных.
• TravelArea - Геометрия многоугольника, определяющая область поездки.
• Cost - Стоимость, указанная в costValue или costField.
• CostUnit - Единица стоимости, указанная в costUnit.
• Status - Возвращаемый статус: либо "OK", либо "failed:" с последующим сообщением об ошибке.
• Все столбцы, кроме ключевого поля из входного набора данных, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.
• ScriptEvalStr в скриптах диаграмм для получения геометрии области поездки.
• ScriptEval в скриптах диаграмм для получения стоимости.

Этот пример скрипта загрузки генерирует 10-минутные области поездки в Майами и Орландо по координатам:

Этот пример скрипта загрузки генерирует 10-минутные области поездки в Майами и Орландо с использованием именованных точек:

Это пример, который вычисляет области поездки вокруг точек непосредственно в слое областей. Операция вызывается для выборки каждый раз при изменении выборки. Это следует поместить в скрипт загрузки для загрузки данных для примера:

Используйте следующее измерение в слое областей:

Используйте условие вычисления в слое областей:

В свойстве Местоположение поместите это:

Возвращает отношения между двумя наборами данных, где геометрия в одном наборе данных (вложенном) полностью находится внутри области в другом наборе данных (охватывающем). Возвращает таблицу, которая сопоставляет ключ во вложенном наборе данных и ключ в охватывающем наборе данных для всех найденных отношений.

Используйте within обычно для поиска того, в каких областях находятся данные; например, для проверки GPS-позиции на предмет того, в какой административной области она находится. Это своего рода обратное геокодирование.

Возвращает следующие столбцы:

• <enclosed name>_<enclosing name>_RelationId - Ключ, сгенерированный для отношения между двумя геометриями.
• <enclosed key column> - Ключевое поле из входного набора данных dataset1.
• <enclosing key column> - Ключевое поле из входного набора данных dataset2.
• Все столбцы, кроме ключевого поля из enclosed набора данных, с префиксом имени набора данных.
• Все столбцы, кроме ключевого поля из enclosing набора данных, с префиксом имени набора данных.

Поддерживает:

• ScriptEval в скриптах загрузки.

Чтобы компенсировать неточности в данных, иногда лучше использовать Closest вместо Within. Например, если у вас есть точечные данные в прибрежных районах, которые вы хотите связать с административными областями, небольшие неточности могут привести к тому, что точки окажутся немного за пределами областей.

Это пример скрипта загрузки, который вычисляет, какие точки находятся в каких штатах: