LinearUnitConversionFactor

Краткая информация

Возвращает коэффициент для конвертации измеряемого расстояния в другую линейную единицу.

Обсуждение

Линейные единицы, поддерживаемые функцией, — это те же единицы, которые возвращаются из типа данных параметра геообработки Линейные единицы, за исключением следующих:

  • Unknown - могут конвертироваться только известные единицы.
  • Decimal Degrees - Десятичные градусы измеряются на сфере, и постоянный коэффициент преобразования в другие единицы для них отсутствует.

Узнайте больше о единицах измерения геообработки

Синтаксис

LinearUnitConversionFactor (from_unit, to_unit)
ПараметрОписаниеТип данных
from_unit

The original or source linear unit.

  • KilometersKilometers
  • MetersMeters
  • DecimetersDecimeters
  • MillimetersMillimeters
  • CentimetersCentimeters
  • NauticalMilesIntInternational nautical miles
  • MilesIntStatute miles
  • YardsIntInternational yards
  • FeetIntInternational feet
  • InchesIntInternational inches
  • NauticalMilesUSUS survey nautical miles
  • MilesUSUS survey miles
  • YardsUSUS survey yards
  • FeetUSUS survey feet
  • InchesUSUS survey inches
  • PointsPoints
String
to_unit

The target or destination linear unit.

  • KilometersKilometers
  • MetersMeters
  • DecimetersDecimeters
  • MillimetersMillimeters
  • CentimetersCentimeters
  • NauticalMilesIntInternational nautical miles
  • MilesIntStatute miles
  • YardsIntInternational yards
  • FeetIntInternational feet
  • InchesIntInternational inches
  • NauticalMilesUSUS survey nautical miles
  • MilesUSUS survey miles
  • YardsUSUS survey yards
  • FeetUSUS survey feet
  • InchesUSUS survey inches
  • PointsPoints
String
Возвращаемое значение
Тип данныхОписание
Double

Коэффициент для конвертации значений между линейными единицами.

Пример кода

Пример 1 LinearUnitConversionFactor

Практический пример конвертации международных миль в километры.

import arcpy

# Convert 620.5 MilesInt to Kilometers
620.5 * arcpy.LinearUnitConversionFactor(from_unit="MilesInt", to_unit="Kilometers")

print(area)  # This will print a value of 998.597952
Пример 2 LinearUnitConversionFactor

Конвертирует в скрипте заданное значение в метры для геообработки.



import arcpy
import locale
import sys

dist = arcpy.GetParameter(n)  # Update n to the parameter index
dist_value, dist_unit = dist.split(" ")  # For example, "10 Kilometers"

# Convert the distance into "Meters" as needed later in this script
try:
    conv_factor = arcpy.LinearUnitConversionFactor(dist_unit, "Meters")
except ValueError as e:
    # If fails, the likely distance unit is "Unknown" or "Decimal Degrees".
    # Add code to either deal with it or produce an appropriate error as shown below.
    arcpy.AddError('Invalid linear unit type.')
    sys.exit()

# Apply the conv_factor to the supplied value
# locale.atof is required for locales that don't use a period as the separator
dist_m = locale.atof(dist_value) * conv_factor

Связанные разделы