Python ArcGIS areas_and_lengths用法及代碼示例

本文簡要介紹 python 語言中 arcgis.geometry.areas_and_lengths 的用法。

用法:

arcgis.geometry.areas_and_lengths(polygons, length_unit, area_unit, calculation_type, spatial_ref=4326, gis=None, future=False)

返回：

JSON 作為字典，或 GeometryJob 對象。如果 future = True ，則結果是 Future 對象。調用 result() 獲取響應。

areas_and_lengths 函數計算輸入數組中指定的每個 Polygon 的麵積和周長。

Keys	Description
polygons	要計算麵積和長度的 Polygon 數組。
length_unit	計算多邊形周長的長度單位。如果 calculation_type 是平麵的，則 length_unit 可以是任何 esriUnits 常量(字符串或整數)。如果 calculationType 不是平麵的，則 length_unit 必須是線性 esriUnits 常數，例如 esriSRUnit_Meter`(i.e. `9001`|`LengthUnits.METER ) 或 esriSRUnit_SurveyMile`(i.e. `9035`|`LengthUnits.SURVEYMILE )。如果未指定 length_unit，則單位派生自 spatial_ref 。如果未指定spatial_ref，則單位為米。有關有效單位的列表，請參閱 esriSRUnitType Constants 和 esriSRUnit2Type Constants 。
area_unit	將計算多邊形麵積的麵積單位。如果calculation_type 是平麵的，那麽area_unit 可以是任何esriAreaUnits 常量(字典或枚舉)。如果 calculation_type 不是平麵的，則 area_unit 必須是 esriAreaUnits 常量，例如 AreaUnits.SQUAREMETERS(即 {“areaUnit”: “esriSquareMeters”} )或 AreaUnits.SQUAREMILES(即 {“areaUnit”: “esriSquareMiles”} )。如果未指定 area_unit，則單位派生自 spatial_ref 。如果未指定spatial_ref，則單位為平方米。有關有效單位的列表，請參閱 esriAreaUnits Constants 。有效的 esriAreaUnits 常量列表包括 esriSquareInches | esriSquareFeet | esriSquareYards | esriAcres | esriSquareMiles | esriSquareMillimeters | esriSquareCentimeters | esriSquareDecimeters | esriSquareMeters | esriAres | esriHectares | esriSquareKilometers.
calculation_type	為輸入幾何的麵積和長度計算定義的類型。類型可以是以下值之一： 1. planar - Planar measurements use 2D Euclidean distance to calculate area and length. This should only be used if the area or length needs to be calculated in the given SpatialReference. Otherwise, use preserveShape. 2. geodesic - Use this type if you want to calculate an area or length using only the vertices of the Polygon and define the lines between the points as geodesic segments independent of the actual shape of the Polygon. A geodesic segment is the shortest path between two points on an ellipsoid. 3. preserveShape - This type calculates the area or length of the geometry on the surface of the Earth ellipsoid. The shape of the geometry in its coordinate system is preserved.
future	可選布爾值。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。

>>> # Use case 1
>>> areas_and_lengths(polygons =[polygon1, polygon2,...],
                      length_unit = 9001,
                      area_unit = {"areaUnit": "esriSquareMeters"},
                      calculation_type = "planar")
>>> # Use case 2
>>> from arcgis.geometry import LengthUnits, AreaUnits
>>> areas_and_lengths(polygons =[polygon1, polygon2,...],
                      length_unit = LengthUnits.METER,
                      area_unit = AreaUnits.SQUAREMETERS,
                      calculation_type = "planar",
                      future = True)