操作

傳回表格中地址的點幾何圖形，即地理編碼。 在 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 位址的位置資訊和點幾何圖形。 這在分析 Web 服務的存取資料時非常有用。 傳回的表格包含下列欄位：

• 索引鍵欄位 - 與名稱表格的索引鍵欄位相同。
• <Address Table Ip Field> - 與查閱的 IP 欄位相同。僅在與索引鍵欄位不同時才可用。
• IpPoint - 找到項目的點。
• CountryIso2 - 找到項目的國家/地區代碼。
• Adm1Code - 找到項目的一級行政區代碼。請注意，此代碼並不總是與位置服務傳回的代碼相容。
• City - 找到項目的城市。
• 來自輸入資料集的所有欄 (索引鍵欄位除外)，並以資料集名稱作為前置詞。

IP 地理定位本質上是不精確的。對於許多 IP 位址，可以精確定位到城市，但對於其他 IP 位址，只能解析到國家/地區。

最佳實務是僅將 Ip 欄傳送至 IpLookup 操作。查閱一些 IP 位址的範例：

相同的 IP 在許多列中重複是很常見的。因此，像此範例一樣先篩選出唯一的 IP 可以提高效能：

本產品包含由 MaxMind 建立的 GeoLite2 資料，可從 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，用於取得距離或持續時間。

這是計算資料集中各點之間路線的範例：

這是直接在線條圖層中計算路線的範例。每次選取範圍變更時，都會為選取範圍呼叫該操作。 通常應該有一個計算條件，如果只選取了幾個點，該條件為 true (否則最好在載入指令碼中計算路線)。 這應該放在載入指令碼中以載入資料。例如：

在線條圖層中使用下列維度：

在線條圖層中使用計算條件：

在 Location 屬性 (應設定為 Line geometry) 中，放入此內容以計算從固定位置到所選點的路線：

簡化資料集中的線條和區域幾何圖形。 使用 Simplify 操作而不是 Load 操作來載入地理資料通常很有用，可以獲得更有效率且顯示更快的幾何圖形。

簡化程度會根據區域、物件數量和物件大小自動計算。 然後可以使用 resolution 參數將其調整為更高或更低的解析度。

區域簡化是使用處理拓撲的演算法完成的，可以移除間隙並連接島嶼。

線條簡化是使用中斷點縮減演算法完成的。

請注意，多邊形的重疊會被移除。輸出中不會有重疊的多邊形。

傳回下列欄：

• <dataset key column> - 來自輸入 dataset1 的索引鍵欄位。
• Simplified_<geometry column name> - 原始幾何圖形的簡化版本。
• 來自 dataset 的所有欄 (索引鍵欄位除外)，並以資料集名稱作為前置詞。

支援：

• 載入指令碼中的 ScriptEval。

載入美國各州簡化版本的範例：

計算旅行時間 ISO 區域。 傳回區域內的所有位置都可以在特定時間內到達，或者沿著道路的距離小於特定距離。 傳回包含 ID、旅行區域幾何圖形、中心點、成本、成本單位和狀態 (OK 或 failed) 的表格。

如果您使用 "bird" 作為交通類型，它會在起點周圍產生地理上正確的圓圈。

傳回下列欄：

• <dataset key column> - 來自輸入資料集的索引鍵欄位。
• TravelArea - 定義旅行區域的多邊形幾何圖形。
• Cost - 在 costValue 或 costField 中指定的成本。
• CostUnit - 在 costUnit 中指定的成本單位。
• Status - 傳回的狀態為 "OK" 或 "failed:"，後接錯誤訊息。
• 來自輸入資料集的所有欄 (索引鍵欄位除外)，並以資料集名稱作為前置詞。

支援：

• 載入指令碼中的 ScriptEval。
• 圖指令碼中的 ScriptEvalStr，用於取得旅行區域幾何圖形。
• 圖指令碼中的 ScriptEval，用於取得成本。

此載入指令碼範例從座標在邁阿密和奧蘭多產生 10 分鐘的旅行區域：

此載入指令碼範例使用具名點在邁阿密和奧蘭多產生 10 分鐘的旅行區域：

這是直接在區域圖層中計算點周圍旅行區域的範例。每次選取範圍變更時，都會為選取範圍呼叫該操作。 這應該放在載入指令碼中以載入範例的資料：

在區域圖層中使用下列維度：

在區域圖層中使用計算條件：

在 Location 屬性中放入此內容：

傳回兩個資料集之間的關係，其中一個資料集 (被包含) 中的幾何圖形完全位於另一個資料集 (包含) 的區域內。 傳回一個表格，該表格對應被包含中的索引鍵與包含中的索引鍵，適用於所有找到的關係。

通常使用 within 來尋找資料所在的區域； 例如，測試 GPS 位置以了解它們位於哪個行政區。 這是一種反向地理編碼。

傳回下列欄：

• <enclosed name>_<enclosing name>_RelationId - 為兩個幾何圖形之間的關係產生的索引鍵。
• <enclosed key column> - 來自輸入 dataset1 的索引鍵欄位。
• <enclosing key column> - 來自輸入 dataset2 的索引鍵欄位。
• 來自 enclosed 資料集的所有欄 (索引鍵欄位除外)，並以資料集名稱作為前置詞。
• 來自 enclosing 資料集的所有欄 (索引鍵欄位除外)，並以資料集名稱作為前置詞。

支援：

• 載入指令碼中的 ScriptEval。

為了補償資料中的不準確性，有時最好使用 Closest 而不是 Within。例如，如果您有沿海地區的點資料，並希望將其與行政區建立關聯，微小的不準確性可能會使點稍微落在區域之外。

這是計算哪些點位於哪些州/省內的載入指令碼範例：