Создать геометрию объектов из GTFS (Конвертация)

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

Генерирует оценку путей, пройденных транспортными средствами в системе общественного транспорта. Выходные данные этого инструмента могут использоваться для построения нового файла shapes.txt или набора данных общественного транспорта GTFS.

Дополнительный файл GTFS shapes.txt содержит географическое представление путей, по которым перемещаются транспортные средства в транзитной системе. Качество файла shapes.txt важно для приложений маршрутизации на базе GTFS для корректного отображения маршрутов транспорта на карте. Многие транспортные агентства создают файлы shapes.txt с помощью GPS-трекеров на своих транспортных средствах, но другие агентства, не имеющие такого оборудования, могут столкнуться с трудностями при создании этого файла.

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

Этот инструмент предназначен для рабочего процесса, состоящего из трех основных шагов:

  1. Запустите этот инструмент, чтобы создать оценки географических путей, используемых транспортом в системе общественного транспорта.
  2. Используйте карту для проверки предложенной геометрии и стандартными инструментами редактирования для внесения исправлений.
  3. Запустите инструмент Объекты в геометрию GTFS, чтобы создать файл shapes.txt для набора данных GTFS.

Примечание:

Инструменты GTFS геометрию в пространственные объекты и Создать геометрию объектов из GTFS используются для различных целей. Используйте GTFS геометрию в пространственные объекты если в вашем наборе данных GTFS уже есть файл shapes.txt , и вы хотите конвертировать эти формы в класс пространственных объектов для отображения на карте. Используйте Создать геометрию объектов из GTFS, если в вашем наборе данных GTFS нет файла shapes.txt, и вы хотите задать формы на основе другой информации, содержащейся в наборе данных GTFS, и создать файл shapes.txt.

Использование

  • Этот инструмент оценивает геометрию маршрутов в сети общественного транспорта, используя одну из следующих опций для каждого режима передвижения в данных:

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

    Если два варианта генерации геометрии маршрутов на базе дорожной сети:

    • Использовать локальный набор сетевых данных – для этой опции необходим Расширение ArcGIS Network Analyst и набор сетевых данных.
    • Использовать сервис портала - для этой опции требуется учетная запись ArcGIS Online с правами на построение маршрутов и достаточным количеством кредитов или портал с настроенным сервисом построения маршрутов ArcGIS Enterprise. Перед запуском инструмента необходимо войти на портал.

  • При вычислении геометрии маршрутов вдоль дорожной сети, Network Analyst может не вычислить маршрут между остановками для некоторых вариантов геометрии. В таких случаях, поскольку геометрия сети не может быть создана, инструмент создает прямолинейную геометрию и возвращает предупреждение, что были затронуты значения shape_id.

  • При проверке и исправлении выходных данных инструмента, можно использовать определяющий запрос для отображения на карте только одной геометрии и связанных с ней остановок. Используйте поле shape_id в обоих выходных данных для выбора отображаемой геометрии. Поле sequence в выходных остановках показывает порядок их посещения.

  • Примечание:

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

    Перед запуском инструмента Объекты в геометрию GTFS проверьте выходные объекты геометрии, полученные из этого инструмента, и внесите в геометрию изменения. Это гарантирует, что итоговый выходной файл shapes.txt будет точным, и поможет избежать ошибок при вычислении поля shape_dist_traveled в файле stop_times.txt.

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

    Используйте инструмент редактирования Изменить форму, чтобы исправить геометрию. Чтобы полностью заменить геометрию, вручную оцифровав ее на карте, используйте инструмент Заменить геометрию.

    Если остановки находятся в неправильных местах, используйте инструмент Остановки GTFS в объекты и Объекты в остановки GTFS, чтобы исправить их, и снова запустите инструмент.

  • При изучении и редактировании выходных данных инструмента, можно редактировать геометрию объектов и атрибуты, но удалять строки нельзя. Удаленные строки могут вызвать ошибки при запуске инструмента Объекты в геометрию GTFS.

Параметры

ПодписьОписаниеТип данных
Входная папка GTFS

Папка, содержащая набор данных GTFS, для которого вы хотите создать файл shapes.txt. Папка должна содержать файлы GTFS stops.txt, trips.txt,routes.txt и stop_times.txt.

Folder
Выходные линии геометрии общественного транспорта

Линейный класс объектов, представляющий оценочную геометрию маршрута, вычисленную инструментом. Каждая строка выходных данных представляет уникальную геометрию, которая требуется для этого набора данных GTFS. Вы можете отредактировать линейную геометрию и использовать этот класс объектов как входной для инструмента Объекты в геометрию GTFS.

Feature Class
Выходные остановки геометрии

Класс точечных объектов остановок GTFS с ID, связывающим их с каждой линейной геометрией, которая будет создана инструментом. В случаях, когда одна и та же остановка GTFS находится на нескольких линиях, этот класс объектов должен содержать несколько копий остановки, по одной на каждую геометрию, с которой она связана. Этот класс объектов можно обрабатывать с помощью определяющего запроса для редактирования одной линейной геометрии за один раз. Используйте этот класс объектов как входной для инструмента Объекты в геометрию GTFS.

Примечание:

Выходной класс объектов не является эквивалентом выходных данных инструмента Остановки GTFS в объекты. Тот инструмент создает класс объектов остановок GTFS в том же виде, что и в исходном наборе данных, а данный инструмент создает несколько копий каждой остановки, чтобы связать их с различной геометрией. Этот выходной класс пространственных объектов должен использоваться вместе с другими выходными данными инструмента Создать геометрию объектов из GTFS для получения файла shapes.txt.

Feature Class
Выходные поездки GTFS

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

File
Режимы передвижения для сети
(Дополнительный)

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

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

Режимы задаются с помощью кодов, приведенных в таблице ниже. Они соответствуют допустимым значениям GTFS routes.txt route_type из документации по GTFS.

Режимы 3 5, и 11 применяются по умолчанию.

  • Трамвай, наземное метро (GTFS 0)Трамвай, наземное метро. Этот режим соответствует GTFS route_type 0.
  • Метро (GTFS 1)Метро. Этот режим соответствует GTFS route_type 1.
  • Железная дорога (GTFS 2)Железная дорога. Этот режим соответствует GTFS route_type 2.
  • Автобус (GTFS 3)Автобус. Этот режим соответствует GTFS route_type 3.
  • Паром (GTFS 4)Паром. Этот режим соответствует GTFS route_type 4.
  • Подвесная дорога (GTFS 5)Подвесная дорога. Этот режим соответствует GTFS route_type 5.
  • Подъемник, подвесная канатная дорога, подъемник открытого типа (GTFS 6)Подъемник, подвесная канатная дорога, подъемник открытого типа, фуникулер. Этот режим соответствует GTFS route_type 6.
  • Фуникулер (GTFS 7)Фуникулер. Этот режим соответствует GTFS route_type 7.
  • Троллейбус (GTFS 11)Троллейбус. Этот режим соответствует GTFS route_type 11.
  • Монорельс (GTFS 12)Монорельс. Этот режим соответствует GTFS route_type 12.
  • Другой режим передвиженияЭта опция соответствует любому режиму общественного транспорта, не охваченный другими опциями.
String
Источник сетевых данных
(Дополнительный)

Набор сетевых данных или сервис, который будет использоваться для вычисления геометрии маршрута по дорожной сети. Можно использовать путь к набору сетевых данных, объект слоя набора сетевых данных, строку с именем слоя набора сетевых данных или URL-адреса портала для сервиса сетевого анализа. Сеть должна содержать хотя бы один режим перемещения.

Для использования URL-адреса портала необходимо выполнить вход на портал под учетной записью с правами на маршрутизацию.

Работа инструмента требует кредитов, если вы используете ArcGIS Online как источник сетевых данных.

Более подробно об оценке использования кредитов этим инструментом

Этот параметр обязателен при выборе любых режимов сети.

Примечание:

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

Network Data Source
Режим передвижения
(Дополнительный)

Режим передвижения сетевого источника данных, использующийся при вычислении геометрии маршрутов по дорожной сети. Вы можете указать режим передвижения как имя строки режима передвижения или как объект arcpy.nax.TravelMode.

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

Этот параметр обязателен при выборе любых режимов сети.

Примечание:

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

Network Travel Mode
Сторона дороги, по которой передвигается транспортное средство
(Дополнительный)

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

  • СлеваТранспортные средства передвигаются по левой стороне дороги.
  • СправаТранспортные средства передвигаются по правой стороне дороги. Это значение по умолчанию
String
Допуск направления
(Дополнительный)

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

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

Укажите значение в градусах в диапазоне между 0 и 180. Значение по умолчанию равно 30.

Double
Разница максимального угла направления
(Дополнительный)

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

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

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

Укажите значение в градусах в диапазоне между 0 и 180. Значение по умолчанию равно 65.

Double

arcpy.conversion.GenerateShapesFeaturesFromGTFS(in_gtfs_folder, out_shape_lines, out_shape_stops, out_gtfs_trips, {network_modes}, {network_data_source}, {travel_mode}, {drive_side}, {bearing_tolerance}, {max_bearing_angle})
ИмяОписаниеТип данных
in_gtfs_folder

Папка, содержащая набор данных GTFS, для которого вы хотите создать файл shapes.txt. Папка должна содержать файлы GTFS stops.txt, trips.txt,routes.txt и stop_times.txt.

Folder
out_shape_lines

Линейный класс объектов, представляющий оценочную геометрию маршрута, вычисленную инструментом. Каждая строка выходных данных представляет уникальную геометрию, которая требуется для этого набора данных GTFS. Вы можете отредактировать линейную геометрию и использовать этот класс объектов как входной для инструмента Объекты в геометрию GTFS.

Feature Class
out_shape_stops

Класс точечных объектов остановок GTFS с ID, связывающим их с каждой линейной геометрией, которая будет создана инструментом. В случаях, когда одна и та же остановка GTFS находится на нескольких линиях, этот класс объектов должен содержать несколько копий остановки, по одной на каждую геометрию, с которой она связана. Этот класс объектов можно обрабатывать с помощью определяющего запроса для редактирования одной линейной геометрии за один раз. Используйте этот класс объектов как входной для инструмента Объекты в геометрию GTFS.

Примечание:

Выходной класс объектов не является эквивалентом выходных данных инструмента Остановки GTFS в объекты. Тот инструмент создает класс объектов остановок GTFS в том же виде, что и в исходном наборе данных, а данный инструмент создает несколько копий каждой остановки, чтобы связать их с различной геометрией. Этот выходной класс пространственных объектов должен использоваться вместе с другими выходными данными инструмента Создать геометрию объектов из GTFS для получения файла shapes.txt.

Feature Class
out_gtfs_trips

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

File
network_modes
[network_modes,...]
(Дополнительный)

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

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

Режимы задаются с помощью кодов, приведенных в таблице ниже. Они соответствуют допустимым значениям GTFS routes.txt route_type из документации по GTFS.

Режимы 3 5, и 11 применяются по умолчанию.

  • 0Трамвай, наземное метро. Этот режим соответствует GTFS route_type 0.
  • 1Метро. Этот режим соответствует GTFS route_type 1.
  • 2Железная дорога. Этот режим соответствует GTFS route_type 2.
  • 3Автобус. Этот режим соответствует GTFS route_type 3.
  • 4Паром. Этот режим соответствует GTFS route_type 4.
  • 5Подвесная дорога. Этот режим соответствует GTFS route_type 5.
  • 6Подъемник, подвесная канатная дорога, подъемник открытого типа, фуникулер. Этот режим соответствует GTFS route_type 6.
  • 7Фуникулер. Этот режим соответствует GTFS route_type 7.
  • 11Троллейбус. Этот режим соответствует GTFS route_type 11.
  • 12Монорельс. Этот режим соответствует GTFS route_type 12.
  • OTHERЭта опция соответствует любому режиму общественного транспорта, не охваченный другими опциями.
String
network_data_source
(Дополнительный)

Набор сетевых данных или сервис, который будет использоваться для вычисления геометрии маршрута по дорожной сети. Можно использовать путь к набору сетевых данных, объект слоя набора сетевых данных, строку с именем слоя набора сетевых данных или URL-адреса портала для сервиса сетевого анализа. Сеть должна содержать хотя бы один режим перемещения.

Для использования URL-адреса портала необходимо выполнить вход на портал под учетной записью с правами на маршрутизацию.

Работа инструмента требует кредитов, если вы используете ArcGIS Online как источник сетевых данных.

Более подробно об оценке использования кредитов этим инструментом

Этот параметр обязателен при выборе любых режимов сети.

Примечание:

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

Network Data Source
travel_mode
(Дополнительный)

Режим передвижения сетевого источника данных, использующийся при вычислении геометрии маршрутов по дорожной сети. Вы можете указать режим передвижения как имя строки режима передвижения или как объект arcpy.nax.TravelMode.

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

Этот параметр обязателен при выборе любых режимов сети.

Примечание:

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

Network Travel Mode
drive_side
(Дополнительный)

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

  • LEFTТранспортные средства передвигаются по левой стороне дороги.
  • RIGHTТранспортные средства передвигаются по правой стороне дороги. Это значение по умолчанию
String
bearing_tolerance
(Дополнительный)

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

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

Укажите значение в градусах в диапазоне между 0 и 180. Значение по умолчанию равно 30.

Double
max_bearing_angle
(Дополнительный)

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

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

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

Укажите значение в градусах в диапазоне между 0 и 180. Значение по умолчанию равно 65.

Double

Пример кода

GenerateShapesFeaturesFromGTFS, пример 1 (окно Python)

В следующем скрипте показано, как использовать функцию GenerateShapesFeaturesFromGTFS в окне Python с помощью локального набора сетевых данных:

Прежние версии:

Инструмент перенесен в Группу инструментов Общественный транспорт в ArcGIS Pro 2.9. Синтаксис в строке кода использует псевдоним группы инструментов transit, соответствующий новому местоположению инструмента. Тем не менее псевдоним группы инструментов conversion также работает. Вам не нужно редактировать существующие скрипты, но в новых скриптах рекомендуется использовать псевдоним transit.

arcpy.transit.GenerateShapesFeaturesFromGTFS(
    r"C:\Data\GTFS",
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Shapes",
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Stops",
    r"C:\Data\GTFSShapes\trips_new.txt",
    ["3", "5", "11"],
    r"C:\Data\NetworkDatasets\Network.gdb\Routing\Routing_ND",
    "Bus Driving Time", "Right", 30, 65
)
GenerateShapesFeaturesFromGTFS, пример 2 (окно Python)

В следующем скрипте показано, как использовать функцию GenerateShapesFeaturesFromGTFS в окне Python с сервисами ArcGIS Online для генерации геометрии для некоторых режимов передвижения:

Прежние версии:

Инструмент перенесен в Группу инструментов Общественный транспорт в ArcGIS Pro 2.9. Синтаксис в строке кода использует псевдоним группы инструментов transit, соответствующий новому местоположению инструмента. Тем не менее псевдоним группы инструментов conversion также работает. Вам не нужно редактировать существующие скрипты, но в новых скриптах рекомендуется использовать псевдоним transit.

arcpy.transit.GenerateShapesFeaturesFromGTFS(
    r"C:\Data\GTFS",
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Shapes",
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Stops",
    r"C:\Data\GTFSShapes\trips_new.txt",
    ["0", "3", "5", "11", "OTHER"],
    "https://www.arcgis.com/",
    "Driving Time", "Right", 30, 65
)
GenerateShapesFeaturesFromGTFS, пример 3 (окно Python)

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

Прежние версии:

Инструмент перенесен в Группу инструментов Общественный транспорт в ArcGIS Pro 2.9. Синтаксис в строке кода использует псевдоним группы инструментов transit, соответствующий новому местоположению инструмента. Тем не менее псевдоним группы инструментов conversion также работает. Вам не нужно редактировать существующие скрипты, но в новых скриптах рекомендуется использовать псевдоним transit.

arcpy.transit.GenerateShapesFeaturesFromGTFS(
    r"C:\Data\GTFS",
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Shapes",
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Stops",
    r"C:\Data\GTFSShapes\trips_new.txt",
    []
)

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да