La utilidad Publicar servicios de generación de rutas le permite publicar en su sitio de ArcGIS Server servicios de indicaciones, generación de rutas y logística basados en un dataset de red. Estos servicios pueden usarse para realizar análisis de rutas, instalación más cercana, área de servicio, ubicación y asignación, matriz de coste de origen a destino o problemas de generación de rutas de vehículos en redes de transportes.
Si el sitio de ArcGIS Server está federado con un portal, estos servicios se configuran como servicios de utilidades con su portal. Una vez publicados, los servicios se pueden usar en aplicaciones cliente, como ArcGIS Pro o Map Viewer Classic del portal de ArcGIS Enterprise, para obtener indicaciones y realizar análisis.
Estos servicios son similares a los servicios de indicaciones y generación de rutas disponibles en ArcGIS Online, pero se basan en su propio dataset de red y se ejecutan en ArcGIS Enterprise.
Licencia:
Para usar esta utilidad, su sitio de ArcGIS Server necesita tener la licencia de Extensión ArcGIS Network Analyst.
Sugerencia:
Los servicios creados por esta utilidad se han mejorado considerablemente en ArcGIS Server 10.8. Si va a actualizar su sitio de ArcGIS Server existente desde versiones anteriores, se recomienda eliminar cualquier servicio de generación de rutas existente creado por esta herramienta en la versión anterior de su sitio de servidor y volver a publicar los servicios de generación de rutas con la versión más reciente de la herramienta.
Requisitos de datos
Puede usar esta utilidad con un dataset de red disponible como parte de ArcGIS StreetMap Premium o con su propio dataset de red almacenado en una geodatabase de archivos, una geodatabase corporativa o un paquete de mapas móviles. Antes de ejecutar la utilidad, el dataset de red se debe copiar (en la misma ruta de directorio) en todos los equipos que participen en su sitio de ArcGIS Server. Si su dataset de red está almacenado en una geodatabase corporativa, todos los equipos de su sitio de servidor deben poder acceder a la geodatabase corporativa.
Sugerencia:
Si bien es posible mantener los datasets de red basados en una geodatabase de archivos o basados en un paquete de mapas móviles en una ubicación compartida accesible para todos los equipos de su sitio de servidor, se recomienda copiar el dataset de red localmente en cada equipo para un óptimo rendimiento al ejecutar los servicios.
Si sus datos de ArcGIS StreetMap Premium tienen licencia, debe instalar la licencia de datos adecuada en cada equipo antes de ejecutar esta utilidad. Siga las instrucciones de instalación de la licencia de datos en Linux.
La utilidad admite en los datasets de red de ArcGIS StreetMap Premium 2015 versión 1 o posteriores.
Heredado:
No se admiten versiones anteriores de datasets de red de ArcGIS StreetMap Premium (ni siquiera datasets de red en formato SDC).
Si está utilizando su propio dataset de red, este debe cumplir las siguientes condiciones:
- Tiene al menos un atributo de coste basado en el tiempo y uno basado en la distancia
- Define al menos un modo de viaje
- Admite indicaciones
Si utiliza un dataset de red de un paquete de mapas móviles, como los paquetes de mapas móviles de StreetMap Premium for ArcGIS, debe ejecutar primero la herramienta de geoprocesamiento Extraer paquete para extraer el contenido del paquete de mapas móviles en una carpeta local antes de ejecutar la utilidad Publicar servicios de generación de rutas.
Parámetros
Una vez configurado correctamente el dataset de red en su sitio de ArcGIS Server, puede ejecutar la utilidad Publicar servicios de generación de rutas con los siguientes parámetros:
| Parámetro | Detalles |
|---|---|
-u | Nombre de usuario de un usuario que tenga privilegios de publicado o responsable de publicación en el sitio de ArcGIS Server. Si el sitio está federado con un portal, el usuario debe ser un usuario de portal y puede tener privilegios administrativos o un privilegio de publicador que permita la publicación de herramientas de web y la publicación de capas basadas en servidor. Si el sitio no está federado, el usuario debe tener privilegios administrativos. Si su sitio está configurado con la autenticación a nivel Web, especifique un usuario integrado, por ejemplo, la cuenta de administrador del sitio principal o la cuenta de administrador inicial de su portal. |
-p | La contraseña del usuario especificado con el parámetro -u. |
-s | El nombre de dominio totalmente calificado del equipo que ejecuta ArcGIS Server, por ejemplo, gisserver.domain.com, o bien la URL local de su sitio de ArcGIS Server con el formato https://gisserver.domain.com:6443/arcgis. |
-P | El nombre de dominio totalmente calificado del equipo, por ejemplo, gisportal.domain.com, en el que está instalado el Portal con el que se federa su sitio de ArcGIS Server. El valor también puede ser una URL local del portal con el formato https://portaldesig.dominio.com:7443/arcgis. Se requiere un valor para esta opción solamente si el sitio de ArcGIS Server que alojará los servicios de generación de rutas está federado con el portal. |
-n | La ruta completa del dataset de red. Si el dataset de red está en una geodatabase de archivos, el valor para la opción -n debe incluir la ruta a la geodatabase de archivos, el nombre del dataset de red y el nombre del dataset de entidades que contiene el dataset de red. Por ejemplo, un valor para esta opción sería c:\data\Streets.gdb\Routing\Routing_ND en Windows y /data/Streets.gdb/Routing/Routing_ND en Linuxm, siendo Streets.gdb la geodatabase de archivos que contiene un dataset de red denominado Routing_ND en un dataset de entidades denominado Routing. Si el dataset de red está en un paquete de mapas móviles, el valor para la opción -n debe incluir la ruta a la base de datos SQLite de la carpeta de la que se extrajo el paquete de mapas móviles, el nombre del dataset de red y el nombre del dataset de entidades que contiene el dataset de red. Por ejemplo, un valor para esta opción podría ser c:\street_data\p14\northamerica.geodatabase\Routing\Routing_ND en Windows y /data/street_data/p14/northamerica.geodatabase/Routing/Routing_ND en Linux, donde northamerica.geodatabase es la geodatabase SQLite que tiene un dataset de red denominado Routing_ND en un dataset de entidades denominado Routing. Si el dataset de red está en una geodatabase corporativa, el valor para la opción -n debe incluir la ruta al archivo de conexión de base de datos, el nombre del dataset de red y el nombre del dataset de entidades que contiene el dataset de red. Por ejemplo, un valor para esta opción podría ser c:\street_data\egdb.sde\Routing\Routing_ND en Windows y /street_data/egdb.sde/Routing/Routing_ND en Linux, donde egdb.sde es el archivo de conexión para la geodatabase corporativa que tiene un dataset de red denominado Routing_ND en un dataset de entidades denominado Routing. |
-o | La ruta a la carpeta en la que la utilidad creará los archivos de definición de servicio para los servicios y un archivo de registro denominado publishroutingservices.log que contiene los detalles sobre la ejecución y los posibles errores detectados. |
-f | El nombre de la carpeta utilizada para crear todos los servicios de generación de rutas en el sitio de ArcGIS Server. El valor predeterminado es Routing. |
-e | La ruta completa a la clase de entidad de las extensiones que contiene las extensiones de varios datasets de red. Esta opción se debe especificar únicamente si va a publicar servicios que necesitan usar más de un dataset de red. Contacte con Esri Professional Services para obtener más información detallada sobre cómo configurar servicios de generación de rutas con esta opción. |
-S | La lista de solucionadores que se incluirán en los servicios. Las opciones válidas son Route, ClosestFacility, ServiceArea, OriginDestinationCostMatrix, Location-Allocation, VehicleRoutingProblem y LastMileDelivery. El valor para esta opción se especifica como una lista de opciones válidas separada por comas. En los valores de opción se distingue entre mayúsculas y minúsculas. El valor predeterminado es crear servicios para todos los solucionadores. |
-c | La ruta completa, incluido el nombre del archivo que contiene una configuración adicional para los servicios. Puede utilizar este archivo de configuración para especificar determinadas propiedades de los servicios de generación de rutas, como el número mínimo y máximo de instancias de servicio. La carpeta framework/runtime/ArcGIS/Resources/ArcToolBox/Services/routingservices del directorio de instalación de ArcGIS Server incluye dos archivos de configuración de muestra, publishroutingservices.json y publishroutingservices_dedicated.json, que muestran todos los ajustes admitidos. La herramienta utiliza el archivo publishroutingservices.json de forma predeterminada. |
-d | Al especificar esta opción, se crea un servicio dedicado para cada solucionador. Se trata de una opción avanzada. Si se especifica esta opción, su sitio de ArcGIS Server utilizará muchos más recursos de computación y memoria. Esta opción se recomienda solamente para sitios de ArcGIS Server especializados. Si se utiliza esta opción, la opción -c debe especificar un archivo de configuración que sea similar al archivo publishroutingservices_dedicated.json. |
-h | Imprime la ayuda para la utilidad. |
Ejemplos
Los siguientes ejemplos muestran cómo llamar a la utilidad Publicar servicios de generación de rutas en un sitio de ArcGIS Server que está federado con un portal.
Precaución:
Si el valor de alguno de los parámetros admitidos por la utilidad utiliza el carácter @, no podrá especificar los valores de los parámetros en la línea de comandos. En su lugar, deberá guardar los parámetros en un archivo y pasar los parámetros desde el archivo.
Publicar servicios de generación de rutas en ArcGIS Server. En este ejemplo se presupone que la ubicación de instalación de ArcGIS Server es /arcgis/server.
/arcgis/server/tools/publishroutingservices/publishroutingservices -s gisserver.domain.com -P gisportal.domain.com -u admin -p secret -o /data/routing-services/service-definitions -n /data/Streets.gdb/Routing/Routing_NDPuede llamar a la utilidad aprobando los parámetros desde un archivo. Resulta útil si está ejecutando la utilidad como parte de un proceso automático o si no desea escribir todas las opciones en la línea de comandos. Para especificar los parámetros desde un archivo, cree un archivo de texto y especifique cada opción en una línea nueva. El nombre y el valor del parámetro deben ir separados por el signo =. A continuación se muestra un archivo de muestra con varias opciones.
-u=admin
-p=secret
-s=gisserver.domain.com
-P=gisportal.domain.com
-o=/data/routing-services/service-definitions
-n=/data/Streets.gdb/Routing/Routing_NDPara llamar a la herramienta con el archivo tool-params.txt anterior, llame a la herramienta y especifique la ruta al archivo con el símbolo @.
Precaución:
Asegúrese de que el archivo que contiene los parámetros no tenga ninguna línea nueva adicional ni espacios en blanco.
/arcgis/server/tools/publishroutingservices/publishroutingservices @/data/tool-params.txt