Skip To Content

Функции ArcGIS for Excel

Примечание:

Вам необходимо выполнить вход в учетную запись ArcGIS для доступа к функциям ArcGIS for Excel. Если вы не вошли в систему, при наведении курсора на зеленый треугольник в левом верхнем углу выбранной ячейки появится сообщение об ошибке входа. В Microsoft Windows Desktop или macOS вы также увидите желтый значок предупреждения.

Microsoft Excel включает набор функций или формул, которые можно использовать для вычисления различной информации - от простых арифметических сумм до сложной совокупности ячеек.

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

Подсказка:

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

Примечание:

Геокодирование, GeoEnrichment Service и маршрутизация потребляют кредиты. Функции геометрии не потребляют кредиты. Функция SUGGESTADDRESS потребляет кредиты, когда вы запрашиваете более 15 предложений. Функции вспомогательных сервисов не потребляют кредиты. Ваши функции ArcGIS кэшируются, чтобы предотвратить дополнительный расход кредитов при обновлении функций. Этот кэш увеличивает размер файла Microsoft Excel. Чтобы очистить кэш функций ArcGIS for Excel, щелкните кнопку Очистить кэш на панели Настройки.

Вы можете скопировать примеры из этого раздела в рабочую книгу Excel, чтобы показать, как работают функции. Вы также можете использовать функции ArcGIS for Excel в инструменте Конструктор функций ArcGIS.

Некоторые функции ArcGIS могут завершаться сбоем с сообщением об ошибке, что сервис недоступен, при их запуске внутри ячейки в Excel. Обратитесь к администратору вашей организации, чтобы включить сервис или получить дополнительную информацию.

Дополнительную информацию о сервисах см. в документации поArcGIS Enterprise и ArcGIS Online.

В следующих разделах описываются функции ArcGIS for Excel, а также их синтаксис, пример использования и описание параметров.

Примечание:

В примерах функций ниже фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

GETCOORDINATES

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

Синтаксис

ARCGIS.GETCOORDINATES(address, [spatial_reference], [match_details], [geocode_service])

Параметры

ПараметрОписаниеОбязательный параметр

address

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

Да

пространственная привязка

Пространственная привязка для местоположения данной точки. Это может быть либо WKID (число), либо WKT (текст). Смотрите список допустимых значений WKID. По умолчанию используется 4326 (WGS84).

Нет

match_details

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

Нет

geocode_service

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

Нет

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

Пример функции 1

=ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA")

Результат

Долгота (X)Широта (Y)

-117.19479

34.057265

Пример функции 2

=ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA", 4326 , TRUE)

Результат

Долгота (X)Широта (Y)АдресОчки для сопоставленияГеолокаторТип адреса

-117.1948

34.057265

380 New York St, Redlands, CA, 92373, USA

100

Весь мир

PointAddress

GETADDRESS

Это функция Геокодирования. Определите адрес в точке с определенной долготой-широтой с помощью обратного геокодирования.

Синтаксис

ARCGIS.GETADDRESS(longitude(X), latitude(Y), [spatial_reference], [all_data], [geocode_service])

Параметры

ПараметрОписаниеОбязательный параметр

longitude(X)

Долгота точки, для которой ищется ближайший адрес.

Да

latitude(Y)

Широта точки, для которой ищется ближайший адрес.

Да

пространственная привязка

Пространственная привязка для местоположения данной точки. Это может быть либо WKID (число), либо WKT (текст). Смотрите список допустимых значений WKID. По умолчанию используется 4326 (WGS84).

Нет

all_data

Если значение установлено как TRUE, будет возвращен не только обратно геокодированный адрес, но также все характеристики адреса, такие как "Город" или "Регион". По умолчанию – FALSE.

Нет

geocode_service

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

Нет

Пример функции 1

=ARCGIS.GETADDRESS(-70.251, 43.65808)

Результат

Адрес

Standard Baking, 75 Commercial St, Portland, ME, 04101, USA

Пример функции 2

=ARCGIS.GETADDRESS(-70.251, 43.65808, 4326, TRUE)

Результат

Совпадающий адресПолный адресКороткий адресТип адресаТипНазвание местаНомер улицыНазвание улицыБлокСекторКварталРайонCityГородская территорияВспомогательный регионРегионАббревиатура регионаТерриторияПочтовый индексДополнительный почтовый индексСтранаКод страны

Standard Baking

Standard Baking, 75 Commercial St, Portland, ME, 04101, USA

Standard Baking

Точка интереса

Булочная

Standard Baking

75

75 Commercial St.

Портленд

Cumberland county

Мэн

ME

04101

Соединенные Штаты

США

ENRICHBYPOINT

Это функция Геообогащения. Получите расширенную демографическую информацию о людях, местах и предприятиях в определенной области или в пределах указанного расстояния или времени в пути от местоположения. Расстояние по умолчанию - в пределах одной мили вокруг нужной точки.

Синтаксис

ARCGIS.ENRICHBYPOINT(longitude(X), latitude(Y), [spatial_reference], [distance], [unit],[travel_mode],[data_collections],[variables],[include_derivative_variables], [include_studyarea_details])

Параметры

ПараметрОписаниеОбязательный параметр

longitude(X)

Долгота точки интереса.

Да

latitude(Y)

Широта точки интереса.

Да

spatial_reference

Пространственная привязка для местоположения данной точки. Это может быть либо WKID (число), либо WKT (текст). Смотрите список допустимых значений WKID. По умолчанию используется 4326 (WGS84).

Нет

расстояние

Радиус или расстояние от точки, которое используется для вычисления области кольцевого буфера для демографических данных. Например, введите 3 для радиуса в три мили. Значение по умолчанию равно 1.

Нет

unit

Единица измерения параметра distance. Это могут быть метры, километры, футы, ярды, мили или морские мили. Если задан параметр travel_mode, могут также использоваться секунды, минуты или часы. По умолчанию – miles.

Нет

travel_mode

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

Нет

data_collections

Предварительно собранные списки атрибутов, которые будут использоваться для обогащения входных объектов.

Запустите функцию LISTDATACOLLECTIONS для запроса списка подборок данных. Например, используйте KeyUSFacts, KeyGlobalFacts. Значение по умолчанию - KeyGlobalFacts.

Нет

analysis_variables

Переменные, возвращаемые из подборок данных, например KeyGlobalFacts.TOTPOP, AGE.MALE5. Если оставить поле пустым, запрашиваются все переменные подборок данных KeyGlobalFacts.

Запустите функцию LISTDATACOLLECTIONS, чтобы запросить список переменных, или просмотрите Data Collection Finder, чтобы посмотреть список переменных.

Нет

include_derivative_variables

Производные переменные, которые должны быть включены в выходные данные. К ним относятся процент, индекс, среднее или все. Если оставить поле пустым, ни одна производная переменная включена не будет.

Нет

include_studyarea_details

Значение TRUE используется для того, чтобы включить связанные сведения об изучаемой области, такие как метод измерения радиуса и расстояния, используемый для вычисления соответствующей области вокруг точки. По умолчанию FALSE.

Нет

Пример функции 1

=ARCGIS.ENRICHBYPOINT(-90.491, 38.777)

Результат

Общая численность населенияОбщее домохозяйствоСредний размер домохозяйстваЧисленность мужчинЧисленность женщин

11464

4860

1.98

5745

5719

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

Пример функции 2

=ARCGIS.ENRICHBYPOINT(-90.491, 38.777, 4326, 5, "miles", "driving", "health", "X8001_X, X8021_X", "index", TRUE)

Результат

Код страныТип областиПсевдоним единиц измерения буфераРадиусы буфера2022 HealthcareЗдравоохранение: индекс, 2022Стоматологические услуги, 2022Стоматологические услуги: индекс, 2022

US

NetworkServiceArea

Расстояние пути в милях

5

240971277

99

15463985

99

ENRICHBYGEOGRAPHY

Это функция Геообогащения. Получить информацию о людях, местах и ​​предприятиях в определенных административных границах или на таких географических уровнях карты, как районы, штаты и почтовые индексы.

Синтаксис

ARCGIS.ENRICHBYGEOGRAPHY(area_id, geography_level_id, [data_collections], [variables], [include_derivative_variables], [include_geography_details])

Параметры

ПараметрОписаниеОбязательный параметр

area_id

Идентификатор FIPS области, для которой будут получены демографические данные. Запустите функцию LISTGEOGRAPHIES, чтобы запросить список идентификаторов областей для определенного географического уровня. Например, "06" для штата Калифорния.

Да

geography_level_id

Идентификатор регионального уровня, к которому относится идентификатор области. Запустите функцию LISTGEOGRAPHIES, чтобы запросить список идентификаторов областей для определенного географического уровня. Например, "US.States" - это штаты США.

Да

data_collections

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

Запустите функцию LISTDATACOLLECTIONS для запроса списка подборок данных. Пример - "KeyUSFacts, KeyGlobalFacts". Значение по умолчанию - KeyGlobalFacts.

Нет

analysis_variables

Переменные, возвращаемые из подборок данных, например KeyGlobalFacts.TOTPOP, AGE.MALE5. Если оставить поле пустым, запрашиваются все переменные подборок данных KeyGlobalFacts.

Запустите функцию LISTDATACOLLECTIONS, чтобы запросить список переменных, или просмотрите Data Collection Finder, чтобы посмотреть список переменных.

Нет

include_derivative_variables

Производные переменные, которые должны быть включены в выходные данные. К ним относятся "процент", "средний индекс" или "все". Если оставить поле пустым, ни одна производная переменная включена не будет.

Нет

include_geography_details

Если установлено значение TRUE, будут включены соответствующие географические данные, такие как код страны, региональный уровень и идентификатор области. По умолчанию – FALSE.

Нет

Пример функции 1

=ARCGIS.ENRICHBYGEOGRAPHY("06","US.States")

Результат

Общая численность населенияОбщее домохозяйствоСредний размер домохозяйстваЧисленность мужчинЧисленность женщин

39770476

13570050

2.86

19767455

20003021

Пример функции 2

=ARCGIS.ENRICHBYGEOGRAPHY("08019","ES.Municipalities", "IncomeTotalsAIS")

Результат

Общий доход домохозяйства в год, 2020Средний доход домохозяйства в год, 2020Средний доход домохозяйства в месяц, 2020Среднегодовой доход на душу населения, 2020Среднемесячный доход на душу населения, 2020

1.99E + 10

29898.9

2491.57

11938.06

994.84

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

Пример функции 3

=ARCGIS.ENRICHBYGEOGRAPHY("08019","ES.Municipalities", , "KeyGlobalFacts.AVGHHSZ, IncomeTotalsAIS.NINCHA")

Результат

Средний размер домохозяйстваСредний доход домохозяйства в год, 2020

2.5

29898.9

Пример функции 4

=ARCGIS.ENRICHBYGEOGRAPHY("06","US.States","health", "X8001_X, X8021_X", "index", TRUE)

Результат

Стандартный географический уровеньСтандартное географическое имяСтандартный географический IDКод страныЗдравоохранение, 2022Здравоохранение: индекс, 2022Стоматологические услуги, 2022Стоматологические услуги: индекс, 2022

U.S. States

штат Калифорния

06

US

1.08894E+11

113

7.37E+09

119

ENRICHBYADDRESS

Это функция Геообогащения. Получите обогащенную демографическую информацию о людях, местах и предприятиях в определенной области или в пределах указанного расстояния или времени в пути от местоположения. Расстояние по умолчанию - в пределах одной мили вокруг нужной точки.

Синтаксис

ARCGIS.ENRICHBYADDRESS(address, [distance], [unit],[travel_mode],[data_collections],[variables],[include_derivative_variables], [include_studyarea_details])

Параметры

ПараметрОписаниеОбязательный параметр

address

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

Да

расстояние

Радиус или расстояние от точки, которое используется для вычисления области кольцевого буфера для демографических данных. Например, введите 3 для радиуса в три мили. Значение по умолчанию равно 1.

Нет

unit

Единица измерения параметра distance. Это могут быть метры, километры, футы, ярды, мили или морские мили. Если задан параметр travel_mode, могут также использоваться секунды, минуты или часы. По умолчанию – miles.

Нет

travel_mode

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

Нет

analysis_variables

Переменные, возвращаемые из подборок данных, например KeyGlobalFacts.TOTPOP, AGE.MALE5. Если оставить поле пустым, запрашиваются все переменные подборок данных KeyGlobalFacts.

Запустите функцию LISTDATACOLLECTIONS, чтобы запросить список переменных, или просмотрите Data Collection Finder, чтобы посмотреть список переменных.

Нет

include_derivative_variables

Производные переменные, которые должны быть включены в выходные данные. К ним относятся процент, индекс, среднее или все. Если оставить поле пустым, ни одна производная переменная включена не будет.

Нет

include_studyarea_details

Значение TRUE используется для того, чтобы включить связанные сведения об изучаемой области, такие как метод измерения радиуса и расстояния, используемый для вычисления соответствующей области вокруг точки. По умолчанию FALSE.

Нет

Пример функции 1

=ARCGIS.ENRICHBYADDRESS("380 New York Street, Redlands, CA, USA")

Результат

Общая численность населенияОбщее домохозяйствоСредний размер домохозяйстваЧисленность мужчинЧисленность женщин

11464

4860

1.98

5745

5719

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

Пример функции 2

=ARCGIS.ENRICHBYADDRESS("380 New York Street, Redlands, CA, USA", 5, "miles", "driving", "health", "X8001_X, X8021_X", "index", TRUE)

Результат

Код страныТип областиПсевдоним единиц измерения буфераРадиусы буфера2022 HealthcareЗдравоохранение: индекс, 2022Стоматологические услуги, 2022Стоматологические услуги: индекс, 2022

US

NetworkServiceArea

Расстояние пути в милях

5

240971277

99

15463985

99

ENRICHBYPOLYGON

Это функция Геообогащения. Получить информацию о людях, местах и предприятиях в определенной области.

Синтаксис

ARCGIS.ENRICHBYPOLYGON (esrijson_polygon, analysis_variables, include_derivative_variables)

Параметры

ПараметрОписаниеОбязательный параметр

esrijson_polygon

Полигон в виде геометрии EsriJSON, представляющий область, для которой будет получена демографическая информация.

Да

analysis_variables

Переменные, возвращаемые из подборок данных, например KeyGlobalFacts.TOTPOP, AGE.MALE5. Если оставить поле пустым, запрашиваются все переменные подборок данных KeyGlobalFacts.

Запустите функцию LISTDATACOLLECTIONS, чтобы запросить список переменных, или просмотрите Data Collection Finder, чтобы посмотреть список переменных.

Да

include_derivative_variables

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

Нет

FINDROUTE

Это функция Маршрутизации. Находит общее расстояние в пути (единицы измерения по умолчанию - мили) и время (в минутах) между двумя адресами, используя наилучший найденный маршрут.

Синтаксис

ARCGIS.FINDROUTE(from_longitude(X), from_latitude(Y), to_longitude(X), to_latitude(Y), [spatial_reference], [travel_mode], [unit], [include_directions])

Параметры

ПараметрОписаниеОбязательный параметр

from_longitude(X)

Координаты долготы для начальной точки маршрута.

Да

from_latitude(Y)

Координаты широты для начальной точки маршрута.

Да

to_longitude(X)

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

Да

to_latitude(Y)

Координаты широты для местоположения назначения маршрута.

Да

spatial_reference

Пространственная привязка для местоположения данной точки. Это может быть либо WKID (число), либо WKT (текст). Смотрите список допустимых значений WKID. По умолчанию используется 4326 (WGS84).

Нет

travel_mode

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

Например, используйте Расстояние поездки на машине или Время пешком. Запустите функцию LISTTRAVELMODES для запроса списка поддерживаемых режимов передвижения. Если оставить поле пустым, будет использоваться режим передвижения по умолчанию, указанный в настройках организации ArcGIS. Подробнее о режимах и параметрах передвижения см. в разделе Настройка режимов передвижения.

Нет

unit

Единица измерения, используемая для определения протяженности пути. Это могут быть мили, километры, метры, футы, точки, ярды или морские мили. По умолчанию используются мили.

Нет

include_directions

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

Нет

Пример функции 1

=ARCGIS.FINDROUTE(-77.24488778, 38.92894278, -80.78300851, 35.1001845)

Результат

Пройденное расстояние (миль)Время в пути (минут)Геометрия маршрута

391.3764

401.6001295

{"spatialReference":{"latestWkid":4326,"wkid":4326},"paths":[[[-77.244918653,38.92906864],[-77.2443203,38.9292242], ...

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

Пример функции 2

=ARCGIS.FINDROUTE(-77.24488778, 38.92894278, -80.78300851, 35.1001845, 4326, "Driving Distance", "miles", TRUE)

Результат

ОписаниеПройденное расстояние (миль)Время в пути (минут)Геометрия маршрута

Общее расстояние/Затраченное время

382.7767

408.1581

Начало в Location 1

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-77.24491862136172,38.92906862347136],[-77.24491862136172,38.92906862347136]]]}

Двигайтесь на восток

0.03108

0.300162

{"spatialReference":{"wkid":4326},"paths":[[[-77.24491862136172,38.92906862347136],[-77.24432026092327,38.92922419358836],[-77.2431644738714,38.92953551367221],[-77.24291516601454,38.92957141170151],[-77.24263625487299,38.92926048728733]]]}

Поверните налево, затем направо на Лисбург Пайк

0.422316089

1.215881348

{"spatialReference":{"wkid":4326},"paths":[[[-77.24263627476374,38.929260492606396],[-77.24232884852634,38.92937681604757], ...

Завершение в Location 2, на левой стороне

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-80.78293244317324,35.10024066538108],[-80.78293244317324,35.10024066538108]]]}

FINDROUTEBYADDRESS

Это функция Маршрутизации. Находит общее расстояние в пути (единицы измерения по умолчанию - мили) и время (в минутах) между двумя адресами, используя наилучший найденный маршрут

Синтаксис

ARCGIS.FINDROUTEBYADDRESS(from_address, to_address, [travel_mode], [unit], [include_directions])

Параметры

ПараметрОписаниеОбязательный параметр

from_address

Адрес пункта отправления на маршруте.

Да

to_address

Адрес местоположения назначения маршрута.

Да

travel_mode

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

Например, используйте Расстояние поездки на машине или Время пешком. Запустите функцию LISTTRAVELMODES для запроса списка поддерживаемых режимов передвижения. Если оставить поле пустым, будет использоваться режим передвижения по умолчанию, указанный в настройках организации ArcGIS. Подробнее о режимах и параметрах передвижения см. в разделе Настройка режимов передвижения.

Нет

unit

Единица измерения, используемая для определения протяженности пути. Это могут быть мили, километры, метры, футы, ярды или морские мили. По умолчанию используются мили.

Нет

include_directions

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

Нет

Пример функции 1

=ARCGIS.FINDROUTEBYADDRESS("380 New York Street Redlands CA", "Downtown Riverside")

Результат

Пройденное расстояние (миль)Время в пути (минут)Геометрия маршрута

14.32662

20.73435

{"spatialReference":{"latestWkid":4326,"wkid":4326},"paths":[[[-117.194789317,34.057516991],[-117.1940741,34.057515], ...

Пример функции 2

=ARCGIS.FINDROUTEBYADDRESS("380 New York Street Redlands CA", "Downtown Riverside", "Driving Distance", "kilometers", TRUE)

Результат

ОписаниеПройденное расстояние (километров)Время в пути (минут)Геометрия маршрута

Общее расстояние/Затраченное время

22.9899

22.40177

Начало в Location 1

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-117.19478927505831,34.057516969635486],[-117.19478927505831,34.057516969635486]]]}

Двигайтесь на восток

0.0660270315239986

0.396162189143992

{"spatialReference":{"wkid":4326},"paths":[[[-117.19478927505831,34.057516969635486],[-117.19407404027919,34.057515005004625]]]}

Поверните налево

0.0665435791015625

0.3992919921875

{"spatialReference":{"wkid":4326},"paths":[[[-117.19407405467044,34.057514980900905],[-117.19406685106797,34.05811489909636]]]}

Завершение в Location 2, на левой стороне

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-117.37829693421398,33.97863201286705],[-117.37829693421398,33.97863201286705]]]}

VERTICESTOESRIJSON

Это функция Геометрии. Создать полилинию или полигональную геометрию EsriJSON из списка координат ее вершин.

Синтаксис

ARCGIS.VERTICESTOESRIJSON (xy_vertices, spatial_reference, geometry_type, y_then_x)

Параметры

ПараметрОписаниеОбязательный параметр

xy_vertices

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

Да

spatial_reference

Пространственная привязка для местоположения данной точки. Это может быть либо WKID (число), либо WKT (текст). Смотрите список допустимых значений WKID. По умолчанию используется 4326 (WGS84).

Нет

geometry_type

Тип геометрии. Значением параметров может быть полилиния или полигон. Значение по умолчанию - полигон.

Нет

y_then_x

Если установлено значение TRUE, это означает, что в координатах сначала указывается широта (Y), а затем долгота (X). По умолчанию — FALSE; по умолчанию предполагается порядок координат: X, за которым следует Y.

Нет

CONVERTTOESRIJSON

Это функция Геометрии. Конвертировать геометрию из формата, отличного от Esri, в геометрию EsriJSON.

Синтаксис

ARCGIS.CONVERTTOESRIJSON (geometry_to_convert)

Параметры

ПараметрОписаниеОбязательный параметр

geometry_to_convert

Геометрия будет конвертирована в EsriJSON. Это может быть геометрия WKT или GeoJSON.

Да

GETPOLYGONAREA

Это функция Геометрии. Вычисляет площадь полигона.

Синтаксис

ARCGIS.GETPOLYGONAREA(esrijson_polygon, unit, measurement_type)

Параметры

ПараметрОписаниеОбязательный параметр

Esrijson_geometry

Геометрия Esri JSON.

Да

Единицы измерения

Единица измерения параметра distance. Это могут быть квадратные миллиметры, квадратные дециметры, квадратные метры, квадратные километры, квадратные дюймы, квадратные футы, квадратные ярды, квадратные мили, квадратные футы США, акры или гектары. Если задан параметр travel_mode, могут также использоваться секунды, минуты или часы. По умолчанию – miles.

Да

Measurement_type

Тип измерения, используемый для определения расстояния. Значения параметра могут быть:

  • Плоскостной
  • Геодезический
  • Локсодромия
  • Ортодромия или большой эллиптический

По умолчанию – Геодезический.

Да

GETGEOMETRYLENGTH

Это функция Геометрии. Вычисляет длину геометрии.

Синтаксис

=ARCGIS.GETGEOMETRYLENGTH(esrijson_geometry, unit, measurement_type)

Параметры

ПараметрОписаниеОбязательный параметр

Esrijson_geometry

Геометрия Esri JSON.

Да

Единицы измерения

Единица измерения параметра distance. Это могут быть сантиметры, дециметры, метры, километры, дюймы, футы, ярды, мили, футы США или морские мили. По умолчанию – miles.

Да

Measurement_type

Тип измерения, используемый для определения расстояния. Значения параметра могут быть:

  • Плоскостной
  • Геодезический
  • Локсодромия
  • Ортодромия или большой эллиптический

По умолчанию – Геодезический.

Да

GETGEOMETRYDISTANCE

Это функция Геометрии. Вычисляет расстояние между двумя геометриями.

Синтаксис

=ARCGIS.GETGEOMETRYDISTANCE(esrijson_geometry1, esrijson_geometry2, unit, measurement_type)

Параметры

ПараметрОписаниеОбязательный параметр

Esrijson_geometry1

Первая геометрия Esri JSON.

Да

Esrijson_geometry2

Вторая геометрия Esri JSON.

Да

Единицы измерения

Единица измерения параметра distance. Это могут быть сантиметры, дециметры, метры, километры, футы, ярды, мили, футы США или морские мили. По умолчанию – miles.

Да

Measurement_type

Тип измерения, используемый для определения расстояния. Значения параметра могут быть:

  • Плоскостной
  • Геодезический
  • Локсодромия
  • Ортодромия или большой эллиптический

По умолчанию – Геодезический.

Да

GETCENTROID

Это функция Геометрии. Вычисляет центроид геометрии.

Синтаксис

=ARCGIS.GETCENTROID(esrijson_geometry)

Параметры

ПараметрОписаниеОбязательный параметр

Esrijson_geometry

Это геометрия Esri JSON.

Да

RELATEGEOMETRIES

Это функция Геометрии. Сравнивает геометрию с другой геометрией, выполнив операцию пространственного отношения.

Синтаксис

=ARCGIS.RELATEGEOMETRIES(esrijson_geometry_or_XY1, topologocal_operation, esrijson_geometry_or_XY2)

Параметры

ИмяОписаниеОбязательный параметр

esrijson_geometry_or_XY1

Геометрия Esri JSON или координаты точки для сравнения.

Да

topologocal_operation

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

  • Содержат
  • Пересекает
  • Равны
  • Пересекает
  • Касается
  • Перекрытия

Да

esrijson_geometry_or_XY2

Геометрия Esri JSON или координаты точки, с которой нужно сравнить.

Да

GENERALIZEGEOMETRY

Это функция Геометрии. Генерализует геометрию с использованием алгоритма Дугласа-Пекера.

Синтаксис

=ArcGIS.GENERALIZEGEOMETRY(esrijson_geometry, max_deviation, max_deviation_unit, remove_degenerate_parts)

Параметры

ПараметрОписаниеОбязательный параметр

Esrijson_geometry

Геометрия Esri JSON.

Да

Max_deviation

Максимально допустимое отклонение от генерализованной геометрии к исходной геометрии. Если maxDeviation равно или меньше 0, оператор возвращает входную геометрию.

Да

Max_deviation_unit

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

Да

Remove_degenerate_parts

Если задано значение TRUE, любые части генерализованной геометрии с меньшей размерностью, чем входные данные (например, полигон, генерализованный до линии), удаляются из выходных данных. Значение по умолчанию – FALSE.

Да

SUGGESTADDRESS

Это вспомогательная функция. Предлагает адреса на основе текстового ввода. Может использоваться как интерактивный поиск адреса с автозаполнением.

Синтаксис

ARCGIS.SUGGESTADDRESS(search_term, [max_suggestions], [country], [geocode_service])

Параметры

ПараметрОписаниеОбязательный параметр

search_term

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

Да

max_suggestions

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

Нет

страна

Ограничивает результаты определенной страной. Например, "United Kingdom". Запустите ARCGIS.LISTGEOGRAPHIES для запроса списка стран.

Нет

geocode_service

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

Нет

Пример функции

=ARCGIS.SUGGESTADDRESS("Orange county",10, "USA")

Результат

Orange County, CA, USA

Orange County, FL, USA

Orange County, IN, USA

Orange County, NC, USA

Orange County, NY, USA

Orange County, TX, USA

Orange County, VA, USA

Orange County, VT, USA

Orange County Great Park, Irvine, CA, USA

Orange County Airport, 500 Dunn Rd, Montgomery, NY, 12549, USA

GETGEOMETRY

Это вспомогательная функция. Получить конкретную географическую единицу, включая ее идентификатор области и ее геометрию.

Синтаксис

ARCGIS.GETGEOMETRY (country, geography_level_id, search_term, exact_match, show_all_matches)

Параметры

ПараметрОписаниеОбязательный параметр

страна

Страна-источник коллекций данных. Например, - штаты США. Запустите функцию LISTGEOGRAPHIES для запроса списка стран.

Да

geography_level_id

Идентификатор регионального уровня, к которому относится идентификатор области. Запустите функцию LISTGEOGRAPHIES, чтобы запросить список идентификаторов областей для определенного географического уровня. Например, "US.States" - это штаты США.

Да

search_term

Название географической единицы, используемое в качестве поискового запроса. Например, используйте Калифорния, Сан-Диего, CA.

Да

exact_match

Возвращать только результаты, соответствующие вашему поисковому запросу.

Нет

show_all_matches

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

Нет

LISTGEOGRAPHIES

Это вспомогательная функция. В зависимости от входных параметров, возвращается список стран, список региональных уровней (например, округа или провинции) страны или список идентификаторов областей географического уровня. Максимальный лимит элемента списка - 5000.

Синтаксис

ARCGIS.LISTGEOGRAPHIES([country], [geography_level_id], [search_term], [exact_match])

Параметры

ПараметрОписаниеОбязательный параметр

страна

Страна-источник коллекций данных. Например, "United Kingdom". Если значение задано, отображается список всех географических уровней для данной страны. Если оставлена пустой, отображаются все страны и территории.

Нет

geography_level_id

Идентификатор географического уровня. Например, "US.States" для штатов США. Если значение задано, будет показан список всех областей этого регионального уровня, например "California" и их идентификаторы FIPS. Если не задано, результаты будут зависеть от параметра country.

Нет

search_term

Поисковый запрос, который сужает результаты путем сопоставления условия поиска с географическими названиями.

Нет

exact_match

Возвращать только результаты, соответствующие вашему поисковому запросу.

Нет

Пример функции

=ARCGIS.LISTGEOGRAPHIES()

Результат

СтранаКод страны

Албания

AL

Алжир

DZ

Андорра

AD

Ангола

AO

Ангилья

AI

=ARCGIS.LISTGEOGRAPHIES("USA")

Результат

IDИмя

US.WholeUSA

Вся страна

US.States

Штаты

US.DMA

Области DMA

US.CD

Избирательные округа

US.CBSA

Участки CBSA

US.Counties

Округа

US.CSD

Подразделения округов

US.ZIP5

Почтовые индексы

US.Places

Большие и малые города (места)

US.Tracts

Переписные районы

US.BlockGroups

Группы районов переписи

=ARCGIS.LISTGEOGRAPHIES("Spain","ES.Municipalities")

Результат

IDИмяОсновное географическое районирование

01001

Alegría-Dulantzi

Страна Басков

01002

Amurrio

Страна Басков

01003

Aramaio

Страна Басков

01004

Artziniega

Страна Басков

01006

Armiñón

Страна Басков

=ARCGIS.LISTGEOGRAPHIES("Spain","ES.Municipalities","Barcelona")

IDИмяОсновное географическое районирование

08019

Барселона

Cataluña

LISTDATACOLLECTIONS

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

Синтаксис

ARCGIS.LISTDATACOLLECTIONS(country, [data_collection_id], [search_term])

Параметры

ПараметрОписаниеОбязательный параметр

страна

Страна-источник коллекций данных. Например, "United Kingdom". Запустите функцию LISTGEOGRAPHIES для запроса списка стран.

Да

data_collection_id

Идентификатор подборки данных. Например, "KeyFacts". Если значение задано, будут указаны все переменные подборки данных. Если не задан, в списке будут указаны все подборки данных для определенной страны.

Нет

search_term

Поисковый запрос, который сужает результаты путем сопоставления условия поиска с именами и описаниями подборок данных или именами и описаниями переменных. Например, "fast food".

Нет

Пример функции

=ARCGIS.LISTDATACOLLECTIONS("USA")

Результат

IDОписаниеПример данных

1yearincrements

Коллекция данных 1 Year Increments включает подсчет населения с разбивкой по возрасту с шагом в 1 год до 84 лет для 2023 и 2028 годов. Коллекция также включает население 2010 года с шагом в один год до достижения возраста 21 года. Таблицы данных включают возраст для общей численности населения и возраст в разбивке по полу. Эта коллекция содержит данные из Обновленной демографической базы данных Esri 2023/2028 годов и Базы данных Esri по переписи 2010 года.

  • 2023 Population Age <1
  • 2023 Population Age 10
  • 2023 Population Age 35

5yearincrements

Коллекция данных 5 Year Increments включает подсчет населения с разбивкой по возрасту с шагом 5 лет для 2023, 2028 и 2010 годов. Таблицы данных включают возраст для общей численности населения и возраст в разбивке по полу. Эта коллекция содержит данные из Обновленной демографической базы данных Esri 2023/2028 годов, базы данных American Community Survey (ACS) и базы Census 2010.

  • 2023 Population Age 0-4
  • 2023 Population Age 25-29
  • 2023 Population Age 40-44

Возраст

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

  • 2023 Males Age 0-4
  • 2023 Females Age 5-9
  • 2023 Males Age 60-64

=ARCGIS.LISTDATACOLLECTIONS("USA","health")

Результат

IDИмяОписание

REL65HI2OC

2023 Pop 65+: Other Health Ins Combos REL (ACS 5-Yr)

2023 Population 65+: Other Health Ins Combinations REL (ACS 5-Yr)

ACSCIVNINS

2023 Civ Noninstitutionalized Population (ACS 5-Yr)

2023 Civilian Noninstitutionalized Population (ACS 5-Yr)

MOECIVNINS

2023 Civ Noninstitutionalized Population MOE (ACS 5-Yr)

2023 Civilian Noninstitutionalized Population MOE (ACS 5-Yr)

=ARCGIS.LISTDATACOLLECTIONS("USA", "health", "<19")

Результат

IDИмяОписание

ACSCIVNI0

2023 Civ Noninstitutionalized Pop <19 (ACS 5-Yr)

2023 Civilian Noninstitutionalized Pop <19 (ACS 5-Yr)

ACS0ONEHI

2023 Pop <19: 1 Type of Health Ins (ACS 5-Yr)

2023 Population <19: One Type of Health Insurance (ACS 5-Yr)

MOE0ONEHI

2023 Pop <19: 1 Type of Health Ins MOE (ACS 5-Yr)

2023 Population <19: One Type of Health Insurance MOE (ACS 5-Yr)

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

LISTTRAVELMODES

Это вспомогательная функция. Перечислите все режимы передвижения этого сервиса маршрутизации, поддерживаемые ArcGIS Online или настроенные для вашей организации.

Примечание:

Эта функция не требует параметров. Похожий пример см. в статье Microsoft Функция RAND.

Синтаксис

ARCGIS.LISTTRAVELMODES()

Пример функции

=ARCGIS.LISTTRAVELMODES()

ИмяОписаниеПодробная информация

Время в пути на машине

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

Avoid Carpool Roads; Avoid Express Lanes; Avoid Gates; Avoid Private Roads; Avoid Unpaved Roads; Driving an Automobile; Roads Under Construction Prohibited; Through Traffic Prohibited; Vehicle Maximum Speed (km/h): TravelTime 0

Время пешком

Моделирует передвижение по тропам и дорогам, предназначенным для пешеходов, при этом находится решение, оптимальное по времени. Скорость движения считается 5 км/ч.

Avoid Private Roads; Avoid Roads Unsuitable for Pedestrians; Preferred for Pedestrians; Walking Speed (km/h): WalkTime 5; Walking

Расстояние пешком

Моделирует передвижение по тропам и дорогам, предназначенным для пешеходов, при этом находится решение, оптимальное по расстоянию.

Avoid Private Roads; Avoid Roads Unsuitable for Pedestrians; Preferred for Pedestrians; Walking Speed (km/h): WalkTime 5; Walking

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

ADDHEADERS

Создать строку заголовка для выходных данных функций ArcGIS for Excel. Эта функция не применима к некоторым функциям, например, к некоторым из категории функций Helper.

Примечание:

Для этой функции требуется только один параметр.

Примечание:

В примерах всех функций фактический результат этой функции исключает заголовок. Запустите функцию ADDHEADERS, чтобы запросить заголовки.

Синтаксис

ARCGIS.ADDHEADERS(ARCGIS_function)

Параметры

ПараметрОписаниеОбязательный параметр

ARCGIS_function

Введите ссылку на ячейку для другой функции ArcGIS for Excel, в которую вы хотите добавить заголовки.

Да

Пример функции

=ARCGIS.ADDHEADERS(A2)

Этот пример будет работать, если у вас есть другая функция в ячейке A2. Например, если в ячейке A2 содержится функция =ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA").

Результат

Долгота (X)

Широта (Y)

Разделители: запятая, десятичная точка и точка с запятой

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

В зависимости от десятичного разделителя функции в Excel должны быть отформатированы по-разному.

  • Когда используется разделитель с десятичной точкой (.), следует разделять входные параметры функции при помощи запятой (,), например, =ARCGIS.GETADDRESS(-70.251, 43.65808).
  • Когда используется разделитель с десятичной запятой (,), следует разделять входные параметры функции при помощи точки с запятой (;), например, =ARCGIS.GETADDRESS(-70,251; 43,65808).

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