使用自訂的 Python 表達式函數¶

警告

本教學已有新的版本，請前往使用自訂的 Python 表達式函數 (QGIS3)。

QGIS 表達式非常的強大，而且也使用在許多核心操作上，像是選取、計算影像值、樣式設定、標記等等。QGIS 也支援使用者自定義的表達式，只要使用一點點的 Python 程式，就可以設計自己的函數，然後把它安插到 QGIS 表達式的引擎中。

內容說明¶

我們要定義一個函數，它可以找出地圖的 UTM 分區。然後我們要使用這個函數設計表達式，讓使用者滑鼠在圖徵上移動的時候，可以顯示出此處的 UTM 分區。

你還會學到這些¶

使用 地圖提示（Map Tips） 工具，在滑鼠游移在某圖徵上時顯示自訂的文字。

取得資料¶

我們要使用 Natural Earth 的人口居住地資料庫，請下載 `簡化版 (欄位較少) 的資料庫<http://www.naturalearthdata.com/http//www.naturalearthdata.com/download/10m/cultural/ne_10m_populated_places_simple.zip>`_。

為了方便起見，你也可以直接用下面的連結下載：

ne_10m_populated_places_simple.zip

操作流程¶

打開 QGIS，選擇圖層 ‣ 加入圖層 ‣ 加入向量圖層。

選擇剛下載的 ne_10m_populated_places_simple.zip 並按下確定。

選擇檢視 ‣ 選取 ‣ 使用表示式選取…。

切換至函數編輯器分頁，這裡你可以撰寫用於在表示式引擎中執行的 PyQGIS 程式碼。

由於 QGIS 中的自訂函數作用在圖徵層級，所以我們可以定義一個稱為 GetUtmZone 的函數，用來計算每個圖徵的 UTM 分區號碼。我們使用每個圖徵的中心經緯度座標來計算 UTM 分區號碼，並且會加上『N』或『S』來標明此區是位在北半球還是南半球。在編輯器中輸入以下程式碼，把檔案取名為 utm_zones.py，然後按下儲存檔案。

備註

UTM 是依照經度把全球投影成 1 到 60 區，每個 UTM 分區都是經度 6 度寬。這裡我們使用的是簡單的數學公式，依照經度的數值來尋找適當的 UTM 分區，所以請注意這個公式並不處理一些比較特殊的 UTM 分區。

import math
from qgis.core import *
from qgis.gui import *

@qgsfunction(args=0, group='Custom', usesgeometry=True)
def GetUtmZone(value1, feature, parent):
    centroid = feature.geometry()
    longitude = centroid.asPoint().x()
    latitude = centroid.asPoint().y()
    zone_number = math.floor(((longitude + 180) / 6) % 60) + 1

    if latitude >= 0:
        zone_letter = 'N'
    else:
        zone_letter = 'S'

    return '%d%s' % (int(zone_number), zone_letter)

按下執行腳本後程式碼會被執行，GetUtmZone 函數會被註冊到表達式引擎中。這個步驟只須執行一次，當函數註冊完畢後，就會一直在表達式引擎中出現。

切換到表示式分頁，在 Select by expression 視窗中，可看到在函數列表的區塊中有個 Custom 群組，其中會出現一個新的函數 GetUtmZone，這代表我們現在可以像使用其他函數一樣使用這個函數了。在文字編輯器中輸入以下表達式，就可以選擇所有落在 40N 的 UTM 分區中的點。按下選取。（譯按：隨著 QGIS 版本的不同，你可能會看到 $GetUtmZone 或 GetUtmZone()，但都是一樣的操作方法。）

$GetUtmZone = '40N'

回到 QGIS 主視窗，現在有許多點都被選取並標為黃色，這些就是符合我們給定的 UTM 分區表達式的點。

現在你已經知道我們要怎麼利用自訂表達式選取圖徵，接下來我們要使用同一個函數做另一件事。在 QGIS 中有個隱藏的神器稱為 地圖提示 工具，它會在你把滑鼠移到圖徵上時顯示使用者定義的文字。請在 ne_10m_populated_places_simple 圖層上按右鍵然後選擇屬性。

切換至顯示分頁，然後選擇 HTML。在這裡你可以輸入任何你想在圖徵上出現的文字，不過更好的做法是我們可以利用圖層屬性值或是表達式來指定更有用的訊息。按下插入表達式鈕。

你會再次看到熟悉的表達式編輯器。我們要利用 concat 函數來連接 name 屬性和 GetUtmZone 函數的輸出字串，因此輸入以下的表達式後，按下確定。

concat("name", ' | UTM Zone: ', $GetUtmZone)

在顯示分頁中的文字訊息內就會看到我們剛剛輸入的表達式。按下確定。

在測試之前，要先取消我們在前幾個步驟選取的點。選擇檢視 ‣ 選取 ‣ 取消所有圖層的圖徵選取。

選擇檢視 ‣ 地圖提示工具以啟動 地圖提示 功能。

縮放至地圖的任一處然後把滑鼠游標放在任何圖徵上，你就會看到城市的名字和對應的 UTM 分區顯示在地圖提示之中。

If you want to give feedback or share your experience with this tutorial, please comment below. (requires GitHub account)

Author

使用自訂的 Python 表達式函數¶

內容說明¶

你還會學到這些¶

取得資料¶

操作流程¶