Операция

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

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

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

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

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

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

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

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

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

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

Этот пример демонстрирует геокодирование в стиле произвольного текста:

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

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

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

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

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

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

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

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

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

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

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

Этот пример позволяет найти ближайшие аэропорты к точкам в таблице:

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

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

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

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

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

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

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

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

• <dissolveField> — поле, заданное как dissolveField в indata.
• DissolvedPolygon — геометрии новых разделенных областей.

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

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

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

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

В этом примере создаются два региона, один из которых состоит из Калифорнии и Арканзаса, а другой — из Вашингтона и Орегона:

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

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

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

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

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

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

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

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

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

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

Рекомендуется передавать только столбец Ip в операцию IpLookup. Пример поиска некоторых IP-адресов:

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

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

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

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

• Все столбцы из набора данных dataset.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В свойстве Location добавьте следующее:

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

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

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

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

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

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

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

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