Подпись | Описание | Тип данных |
Входная папка 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 применяются по умолчанию.
| 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 |
Краткая информация
Генерирует оценку путей, пройденных транспортными средствами в системе общественного транспорта. Выходные данные этого инструмента могут использоваться для построения нового файла shapes.txt или набора данных общественного транспорта GTFS.
Дополнительный файл GTFS shapes.txt содержит географическое представление путей, по которым перемещаются транспортные средства в транзитной системе. Качество файла shapes.txt важно для приложений маршрутизации на базе GTFS для корректного отображения маршрутов транспорта на карте. Многие транспортные агентства создают файлы shapes.txt с помощью GPS-трекеров на своих транспортных средствах, но другие агентства, не имеющие такого оборудования, могут столкнуться с трудностями при создании этого файла.
Этот инструмент, вместе с инструментом Объекты в геометрию GTFS, позволяет создавать файл shapes.txt, основанный на остановках, маршруте и расписании из имеющегося набора данных GTFS. Этот инструмент создает оценки географических путей, используемых общественными транспортными средствами и записывает выходные данные в класс объектов. Вы можете просмотреть и отредактировать эти линейные объекты перед запуском инструмента Объекты в геометрию GTFS, который экспортирует геометрию в новый файл shapes.txt.
Этот инструмент предназначен для рабочего процесса, состоящего из трех основных шагов:
- Запустите этот инструмент, чтобы создать оценки географических путей, используемых транспортом в системе общественного транспорта.
- Используйте карту для проверки предложенной геометрии и стандартными инструментами редактирования для внесения исправлений.
- Запустите инструмент Объекты в геометрию 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.
Параметры
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 применяются по умолчанию.
| String |
network_data_source (Дополнительный) | Набор сетевых данных или сервис, который будет использоваться для вычисления геометрии маршрута по дорожной сети. Можно использовать путь к набору сетевых данных, объект слоя набора сетевых данных, строку с именем слоя набора сетевых данных или URL-адреса портала для сервиса сетевого анализа. Сеть должна содержать хотя бы один режим перемещения. Для использования URL-адреса портала необходимо выполнить вход на портал под учетной записью с правами на маршрутизацию. Работа инструмента требует кредитов, если вы используете ArcGIS Online как источник сетевых данных. Более подробно об оценке использования кредитов этим инструментом Этот параметр обязателен при выборе любых режимов сети. Примечание:Выбранный набор сетевых данных должен подходить для моделирования маршрутов транспортных средств, таких как автобусы, передвигающихся по улицам. Не используйте набор сетевых данных, настроенный на использование данных общественного транспорта с анализатором Общественного транспорта, поскольку этот тип сети моделирует поток пассажиров, а не общественный транспорт, передвигающийся по улицам. | Network Data Source |
travel_mode (Дополнительный) | Режим передвижения сетевого источника данных, использующийся при вычислении геометрии маршрутов по дорожной сети. Вы можете указать режим передвижения как имя строки режима передвижения или как объект arcpy.nax.TravelMode. Используйте режим передвижения, наиболее подходящий для моделирования транспортных средств в транспортной сети, передвигающихся по дорожной сети. Этот параметр обязателен при выборе любых режимов сети. Примечание:Не применяйте режим передвижения с атрибутом импеданса, использующим анализатор Общественный транспорт, поскольку этот режим передвижения моделирует поток пассажиров, а не общественный транспорт, передвигающийся по улицам. | Network Travel Mode |
drive_side (Дополнительный) | Задает сторону дороги, по которой передвигается транспортное средство в транспортной сети. Используется, чтобы гарантировать, что все остановки будут посещены на соответствующей стороне дороги.
| String |
bearing_tolerance (Дополнительный) | Максимально допустимый угол между оценкой направления движения транспортного средства на остановке и углом ребра сети, на котором располагается эта остановка. Если углы отличаются больше, чем на данное значение, Network Analyst предполагает, что это не то ребро, на котором находится остановка, и продолжает поиск других более подходящих ребер. При вычислении геометрии маршрутов вдоль дорожной сети, направление и допуск направления применяются для более точного размещения остановок в дорожной сети. Направление транспортного средства оценивается на каждой остановке, на основе угла между текущей, предыдущей и следующей остановками вдоль маршрута. Укажите значение в градусах в диапазоне между 0 и 180. Значение по умолчанию равно 30. | Double |
max_bearing_angle (Дополнительный) | Максимально допустимая разница в угле направления между предыдущей остановкой и текущей остановкой, а также между текущей и следующей остановками. Направление транспортного средства оценивается на каждой остановке, на основе угла между текущей, предыдущей и следующей остановками вдоль маршрута. Когда маршрут пролегает по сравнительно прямой дороге, этот угол является хорошим указанием направления. Однако если маршрут поворачивает, делает разворот, следует по извилистой дороге или поворачивает на парковку или боковую дорогу, средний угол не является хорошей оценкой реального направления, использование такой оценки может привести к размещению остановки на большом расстоянии от необходимого места и снижает качество выходных данных инструмента. Инструмент игнорирует оценку направления, если разница углов между предыдущей и текущей остановками и текущей и следующей больше, чем значение, заданное этом параметром. В этой ситуации, остановке будет возвращено нормальное поведение при размещении в сети и она будет замкнута на ближайшее разрешенное ребро. Укажите значение в градусах в диапазоне между 0 и 180. Значение по умолчанию равно 65. | Double |
Пример кода
В следующем скрипте показано, как использовать функцию 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 в окне 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
)
В следующем скрипте показано, как генерировать прямолинейную геометрию для всех режимов передвижения, используя пустой список для параметра 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: Да