diff --git a/CMakeLists.txt b/CMakeLists.txt index cec567afe..4ddbbdc74 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -76,20 +76,16 @@ set(PLACE_4 "Sky tower") set(PLACE_5 "Emily Place Reserve") -# Example reference point (e.g., near Emily Place Reserve) set(CH7_PLACE_1 ${PLACE_5}) set(CH7_OSMID_1 ${OSMID_5}) set(CH7_PLACE_2 ${PLACE_1}) set(CH7_OSMID_2 ${OSMID_1}) -set(POINT1_LAT "-36.8471438") -set(POINT1_LON "174.7710042") - -# Example reference point (e.g., near Auckland University of Technology) -set(POINT2_LAT "-36.8524328") -set(POINT2_LON "174.766749") - +set(POINT1_LAT "-36.850329") +set(POINT1_LON "174.763094") +set(POINT2_LAT "-36.853675") +set(POINT2_LON "174.764448") #--------------------------------------------- # minimum versions diff --git a/docs/basic/CMakeLists.txt b/docs/basic/CMakeLists.txt index c91fa0ad7..80d0bd020 100644 --- a/docs/basic/CMakeLists.txt +++ b/docs/basic/CMakeLists.txt @@ -11,7 +11,7 @@ set(PGR_WORKSHOP_FILES pedestrian.rst vehicle.rst sql_function.rst - plpgsql_function.rst + withPoints.rst ) set(PGR_WORKSHOP_SUBDIRS diff --git a/docs/basic/images/CMakeLists.txt b/docs/basic/images/CMakeLists.txt index 0d3defb9a..91cdd0458 100644 --- a/docs/basic/images/CMakeLists.txt +++ b/docs/basic/images/CMakeLists.txt @@ -8,7 +8,7 @@ set(PGR_WORKSHOP_IMG_SUBDIRS vehicle graphs sql_function - plpgsql_function + withPoints ) foreach (dir ${PGR_WORKSHOP_IMG_SUBDIRS}) diff --git a/docs/basic/images/plpgsql_function/ch8-e7.png b/docs/basic/images/plpgsql_function/ch8-e7.png deleted file mode 100644 index 124664ae2..000000000 Binary files a/docs/basic/images/plpgsql_function/ch8-e7.png and /dev/null differ diff --git a/docs/basic/images/plpgsql_function/ch8-taxinet.png b/docs/basic/images/plpgsql_function/ch8-taxinet.png deleted file mode 100644 index b847422ef..000000000 Binary files a/docs/basic/images/plpgsql_function/ch8-taxinet.png and /dev/null differ diff --git a/docs/basic/images/plpgsql_function/ch8-vehiclenet.png b/docs/basic/images/plpgsql_function/ch8-vehiclenet.png deleted file mode 100644 index bd8adee91..000000000 Binary files a/docs/basic/images/plpgsql_function/ch8-vehiclenet.png and /dev/null differ diff --git a/docs/basic/images/plpgsql_function/ch8-walknet.png b/docs/basic/images/plpgsql_function/ch8-walknet.png deleted file mode 100644 index 2ab22e074..000000000 Binary files a/docs/basic/images/plpgsql_function/ch8-walknet.png and /dev/null differ diff --git a/docs/basic/images/plpgsql_function/closest_vertex.png b/docs/basic/images/plpgsql_function/closest_vertex.png deleted file mode 100644 index 668a2cda9..000000000 Binary files a/docs/basic/images/plpgsql_function/closest_vertex.png and /dev/null differ diff --git a/docs/basic/images/plpgsql_function/CMakeLists.txt b/docs/basic/images/withPoints/CMakeLists.txt similarity index 72% rename from docs/basic/images/plpgsql_function/CMakeLists.txt rename to docs/basic/images/withPoints/CMakeLists.txt index 273701a0f..58830f01e 100644 --- a/docs/basic/images/plpgsql_function/CMakeLists.txt +++ b/docs/basic/images/withPoints/CMakeLists.txt @@ -3,12 +3,9 @@ # Files #--------------------- set(PGR_WORKSHOP_IMG_FILES - closest_vertex.png - ch8-e7.png - ch8-taxinet.png - ch8-vehiclenet.png - ch8-walknet.png - ) + points_on_map.png + points_routing.png +) foreach (f ${PGR_WORKSHOP_IMG_FILES}) diff --git a/docs/basic/images/withPoints/points_on_map.png b/docs/basic/images/withPoints/points_on_map.png new file mode 100644 index 000000000..2bc819557 Binary files /dev/null and b/docs/basic/images/withPoints/points_on_map.png differ diff --git a/docs/basic/images/withPoints/points_routing.png b/docs/basic/images/withPoints/points_routing.png new file mode 100644 index 000000000..0d0534485 Binary files /dev/null and b/docs/basic/images/withPoints/points_routing.png differ diff --git a/docs/basic/plpgsql_function.rst b/docs/basic/plpgsql_function.rst deleted file mode 100644 index cccd4ff78..000000000 --- a/docs/basic/plpgsql_function.rst +++ /dev/null @@ -1,466 +0,0 @@ -.. - **************************************************************************** - pgRouting Workshop Manual - Copyright(c) pgRouting Contributors - - This documentation is licensed under a Creative Commons Attribution-Share - Alike 3.0 License: http://creativecommons.org/licenses/by-sa/3.0/ - **************************************************************************** - -pl/pgsql function -############################################################################### - -.. image:: images/pedestrian/pedestrian_one_to_one.png - :width: 250pt - :align: center - -Other kind of functions are `pl/pgsql -`__. As the applications -requirements become more complex, using wrappers of previously defined functions -becomes necessary for clarity. - -.. contents:: Chapter contents - -Requirements for routing from A to B -=============================================================================== - -.. rubric:: Chapter problem: - -* Create a function ``wrk_fromAtoB`` that allows routing from 2 geometries. -* The function takes latitude/longitude points as input parameters. -* Returns a route that includes a geometry so that if can be displayed, for example, in QGIS. -* Will also return some other attributes. - -The detailed description: - -.. rubric:: Input parameters - -================ ========== ================================================ -Parameter type Description -================ ========== ================================================ -``edges_subset`` REGCLASS Edge table name identifier. -``lat1`` NUMERIC The latitude of the `departure` point. -``lon1`` NUMERIC The longitude of the `departure` point. -``lat2`` NUMERIC The latitude of the `destination` point. -``lon2`` NUMERIC The longitude of the `destination` point. -``do_debug`` BOOLEAN Flag to create a ``WARNING`` with the query that - is been executed -================ ========== ================================================ - - -.. rubric:: Output columns - -================= ================================================= -Column Description -================= ================================================= -``seq`` For ordering purposes. -``gid`` The edge identifier that can be used to JOIN the results to the ``ways`` table. -``name`` The street name. -``azimuth`` Between start and end node of an edge. -``length`` In meters. -``minutes`` Minutes taken to traverse the segment. -``route_geom`` The road geometry with corrected directionality. -================= ================================================= - - -For this chapter, the following points will be used for testing. - -* (lat,lon) = (@POINT1_LAT@, @POINT1_LON@) -* (lat,lon) = (@POINT2_LAT@, @POINT2_LON@) - -The Vertices Table -=============================================================================== - -Graphs have a `set of edges` and a `set of vertices` associated to it. -The views need their vertices table. - -Exercise 1: Create vertices table -------------------------------------------------------------------------------- - -.. rubric:: Problem - -* Create a vertices table for the views: - - * ``vehicle_net`` - * ``taxi_net`` - * ``walk_net`` - -.. rubric:: Solution - - -* Use ``pgr_extractVertices`` (explained in :doc:`graphs`) to create the - vertices table -* ``JOIN`` the vertices table with ``ways_vertices`` (created in - :doc:`graphs`) to get the ``x``, ``y``, ``geom`` information. - -For ``vehicle_net``: - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :emphasize-lines: 1,6 - :start-after: views_vertices1.txt - :end-before: views_vertices2.txt - -For ``taxi_net``: - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :start-after: views_vertices2.txt - :end-before: views_vertices3.txt - -For ``walk_net``: - -Modify the above queries to create the ``walk_net_vertices`` table. - -.. collapse:: Answer - - .. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :start-after: views_vertices3.txt - :end-before: exercise_8_3_1.txt - -.. note:: It is left to the reader to remove disconected components on the views. - - See :doc:`graphs` - -Exercise 3: Nearest Vertex -------------------------------------------------------------------------------- - -.. rubric:: Problem - -Calculate the (OSM) identifier of the nearest vertex to a point. - -In particular use the following (lat, lon) value: ``(@POINT1_LAT@, @POINT1_LON@)``. - -* calculate the nearest OSM identifier of the vertex to: - - * ``ways_vertices`` - * ``vehicle_net_vertices`` - * ``taxi_net_vertices`` - * ``walk_net_vertices`` - -.. rubric:: Solution - -* Remember that the ``id`` has an OSM vertex identifier on the vertices tables. -* Using the Postgis distance operator `<-> `__ to order by distance. -* Get only the first row, to obtain the nearest identifier of the vertex. - -For ``ways_vertices``: - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :start-after: exercise_8_3_1.txt - :end-before: exercise_8_3_2.txt - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_3_1.txt - -For ``vehicle_net_vertices``: - -Modify the previous query. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :linenos: - :emphasize-lines: 1,2 - :start-after: exercise_8_3_2.txt - :end-before: exercise_8_3_3.txt - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_3_2.txt - -For ``taxi_net_vertices``: - -Modify the previous query. - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_3_3.txt - -For ``walk_net_vertices``: - -Modify the previous query. - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_3_4.txt - - -Exercise 4: Nearest vertex function -------------------------------------------------------------------------------- - -.. rubric:: Problem - -When operations look similar for different tables, a function can be created. - -* Create a function that calculates the OSM identifier of the nearest vertex to a point. -* Function name: ``wrk_nearest``. -* Needs to work only for the **final application** views and table. - - -The input parameters: - -============ ========== === -Column type Description -============ ========== === -vertex_table REGCLASS Table name identifier. -lat NUMERIC The latitude of a point. -lon NUMERIC The longitude of a point. -============ ========== === - -The output: - -========= ===== -type Description -========= ===== -BIGINT the OSM identifier that is nearest to (lat,lon). -========= ===== - -.. rubric:: Solution - -* The function returns only one ``BIGINT`` value. -* Using `format - `__ - to build the query. - - * The structure of the query is similar to `Exercise 3: Nearest Vertex`_ - solutions. - * ``%1$I`` for the table name identifier. - * ``%2$s`` and ``%3$s`` for the latitude and longitude. - - * The point is formed with (lon/lat) ``(%3$s, %2$s)``. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :force: - :start-after: exercise_8_4.txt - :end-before: exercise_8_5_1.txt - - -Exercise 5: Test nearest vertex function -------------------------------------------------------------------------------- - -.. image:: images/plpgsql_function/ch8-vehiclenet.png - :scale: 15% - :alt: Nearest Vertex in vehicle network - -.. image:: images/plpgsql_function/ch8-taxinet.png - :scale: 15% - :alt: Nearest Vertex in taxi network - -.. image:: images/plpgsql_function/ch8-walknet.png - :scale: 15% - :alt: Nearest Vertex in walk network - -.. rubric:: Problem - -* Test the ``wrk_Nearest`` function. - -Use the following (lat,lon) values: ``(@POINT1_LAT@, @POINT1_LON@)``. - -* The point is the same as in `Exercise 3: Nearest Vertex`_ problem. - - * Verify the results are the same. - -* calculate the nearest OSM identifier of the vertex to: - - * ``ways_vertices`` - * ``vehicle_net_vertices`` - * ``taxi_net_vertices`` - * ``walk_net_vertices`` - -.. rubric:: Solution - -For ``ways_vertices``: - -* Use the function with ``ways_vertices`` as the ``vertex_table`` parameter. -* Pass the (lat,lon) values as second and third parameters. -* Using the function on the original data does not return the OSM identifier. - - The value stored in ``id`` column is not the OSM identifier. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :start-after: exercise_8_5_1.txt - :end-before: exercise_8_5_2.txt - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_5_1.txt - -For ``vehicles_net_vertices``: - -* Modify the previous query. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :start-after: exercise_8_5_2.txt - :end-before: exercise_8_5_3.txt - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_5_2.txt - -For ``taxi_net_vertices``: - -* Modify the previous query. - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_5_3.txt - -For ``walk_net_vertices``: - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_5_4.txt - - -wrk_fromAtoB function -=============================================================================== - -In this section, creation and testing the required function will be tackled. - - -Exercise 6: Creating the main function -------------------------------------------------------------------------------- - -.. rubric:: Problem - -* Create the function ``wrk_fromAtoB``. -* Follow the description given at `Requirements for routing from A to B`_. -* Use specialized functions: - - * ``wrk_NearestOSM`` created on `Exercise 4: Nearest vertex function`_. - - * It receives the point in natural language format. - * Obtains the OSM identifier needed by ``wrk_dijkstra``. - - * ``wrk_dijkstra`` created in :doc:`sql_function` - -.. rubric:: Solution - -The function's signature: - -* The input parameters highlighted. -* The output columns are not highlighted. -* The function returns a set of values. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :emphasize-lines: 2-5 - :start-after: exercise_8_6.txt - :end-before: signature ends - -| - -The function's body: - -Call to the function ``wrk_dijkstra`` - -* Using PostgreSQL ``format`` to make substitutions - - * The first parameter is the string to be replaced - * The rest are the data parameters, are the strings use for replacement. - -* ``wrk_dijkstra`` obtains the values for the output -* The ``edges_subset`` value will replace ``%1$I``: -* For the ``source`` and ``target``: - - * ``wrk_Nearest`` is used to find the identifier. - - * The vertices table name is formed with ``%1$I_vertices``. - - * ``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively. - * ``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively. - -* To get the constructed query in form of a warning: - - * The ``WARNING`` will be issued only when ``do_debug`` is true. - * No output will be generated. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :force: - :emphasize-lines: 9-13, 16-18, 20-22 - :start-after: signature ends - :end-before: exercise_8_7_1.txt - -.. collapse:: The complete function - - .. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :force: - :start-after: exercise_8_6.txt - :end-before: exercise_8_7_1.txt - -Exercise 7: Using the main function -------------------------------------------------------------------------------- - -.. image:: images/plpgsql_function/ch8-e7.png - :scale: 25% - :alt: View of roads for taxis along with source and destination - -.. rubric:: Problem - -Use ``wrk_fromAtoB`` - -* Departure point is: (lat,lon) = ``(@POINT1_LAT@, @POINT1_LON@)`` -* Destination point is: (lat,lon) = ``(@POINT2_LAT@, @POINT2_LON@)`` -* For ``vehicle_net``: - - * Use with default value of ``do_debug``. - -* For ``taxi_net``: - - * Use with ``do_debug`` set to ``true``. - -* For ``walk_net``: - - * Use with default value of ``do_debug``. - * Store results on a table. - * Show the table contents. - - -.. Note:: The function is not meant to be used with ``ways`` - -.. rubric:: Solution - -For ``vehicle_net``: - -* The first parameter is the table name. -* The next two parameters are the latitude and longitude of the departure point. -* The next two parameters are the latitude and longitude of the destination point. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :start-after: exercise_8_7_1.txt - :end-before: exercise_8_7_2.txt - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_7_1.txt - -For ``taxi_net``: - -* Do a dry run by adding ``true`` to get the query that is executed. - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :start-after: exercise_8_7_2.txt - :end-before: exercise_8_7_3.txt - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_7_2.txt - -For ``walk_net``: - -.. literalinclude:: ../scripts/basic/plpgsql_function/plpgsql_function.sql - :language: sql - :start-after: exercise_8_7_3.txt - :end-before: \o - -.. collapse:: Query results - - .. literalinclude:: ../scripts/basic/plpgsql_function/exercise_8_7_3.txt diff --git a/docs/basic/sql_function.rst b/docs/basic/sql_function.rst index e6c0ef517..2aa414699 100644 --- a/docs/basic/sql_function.rst +++ b/docs/basic/sql_function.rst @@ -71,7 +71,7 @@ Name Type Description ``id`` BIGINT The edge identifier. ``name`` TEXT The name of the segment. ``seconds`` FLOAT The number of seconds it takes to traverse the segment. -``length`` FLOAT The leng in meters of the segment. +``length`` FLOAT The length in meters of the segment. ``azimuth`` FLOAT The azimuth of the segment. ``route_readable`` TEXT The geometry in human readable form. ``route_geom`` geometry The geometry of the segment in the correct direction. diff --git a/docs/basic/withPoints.rst b/docs/basic/withPoints.rst new file mode 100644 index 000000000..222eec895 --- /dev/null +++ b/docs/basic/withPoints.rst @@ -0,0 +1,354 @@ +.. + **************************************************************************** + pgRouting Workshop Manual + Copyright(c) pgRouting Contributors + + This documentation is licensed under a Creative Commons Attribution-Share + Alike 3.0 License: http://creativecommons.org/licenses/by-sa/3.0/ + **************************************************************************** + +Routing using points +############################################################################### + +.. image:: images/withPoints/points_routing.png + :width: 250pt + :align: center + +Other kind of functions are `pl/pgsql +`__. As the applications +requirements become more complex, building queries and storing queries in a +variable becomes necessary + +pgRouting functions in this chapter + +- `pgr_findCloseEdges`_ +- `pgr_withPoints`_ + +.. contents:: Chapter contents + +Requirements for routing lat,lon points +=============================================================================== + +.. rubric:: Chapter problem: + +* Create a function ``wrk_withPoints`` that allows routing from two point + geometries and works for + + * ``vehicle_net`` + * ``taxi_net`` + * ``walk_net`` + +* The function takes as input parameters: + + - The edges table name + - Latitude/longitude of two point + +* Returns + + - the same information as in :doc:`sql_function` chapter problem. + - or the query that it builds + + +The detailed description: + +.. rubric:: Input parameters + +================ ========== ================================================ +Parameter type Description +================ ========== ================================================ +``edges_subset`` REGCLASS Edge table name identifier. +``lat1`` NUMERIC The latitude of the `departure` point. +``lon1`` NUMERIC The longitude of the `departure` point. +``lat2`` NUMERIC The latitude of the `destination` point. +``lon2`` NUMERIC The longitude of the `destination` point. +``do_debug`` BOOLEAN Flag to create a ``NOTICE`` with the query that + is been executed +================ ========== ================================================ + + +.. rubric:: Output columns + +================== ========= ================= +Name Type Description +================== ========= ================= +``seq`` INTEGER A unique number for each result row. +``id`` BIGINT The edge identifier. +``name`` TEXT The name of the segment. +``seconds`` FLOAT The number of seconds it takes to traverse the segment. +``length`` FLOAT The length in meters of the segment. +``azimuth`` FLOAT The azimuth of the segment. +``route_readable`` TEXT The geometry in human readable form. +``route_geom`` geometry The geometry of the segment in the correct direction. +================== ========= ================= + + +For this chapter, the following points will be used for testing. + +* (lat,lon) = (@POINT1_LAT@, @POINT1_LON@) +* (lat,lon) = (@POINT2_LAT@, @POINT2_LON@) + +pgr_findCloseEdges +------------------------------------------------------------------------------- + +Finds the close edges to a point geometry. + +.. rubric:: Signature Summary + +.. code-block:: sql + + pgr_findCloseEdges(Edges SQL, point, tolerance, [options]) + pgr_findCloseEdges(Edges SQL, points, tolerance, [options]) + + Options: [cap, dryrun] + + Returns set of (edge_id, fraction, side, distance, geom, edge) + OR EMPTY SET + +Exercise 1: Get the nearest edge +............................................................................... + +.. image:: images/withPoints/points_on_map.png + :scale: 25% + :align: center + +.. rubric:: Problem + +Get the nearest edge on the graph of the following points. + +* (pid, lat, lon) = (1, @POINT1_LAT@, @POINT1_LON@) +* (pid, lat, lon) = (2, @POINT2_LAT@, @POINT2_LON@) + +.. rubric:: Solution + +* Build the geometry of the points with the appropiate SRID. (lines **4** and + **10**) +* Get the union of the individual queries + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :linenos: + :start-after: closestedges.txt + :end-before: route_withPoints.txt + +.. collapse:: Query results + + .. literalinclude:: ../scripts/basic/withPoints/closestedges.txt + +pgr_withPoints +------------------------------------------------------------------------------- + +Returns the shortest path in a graph with additional temporary vertices. + +.. rubric:: Signature Summary + +.. code-block:: sql + + pgr_withPoints(Edges SQL, Points SQL, start vid, end vid, [driving side] [options]) + pgr_withPoints(Edges SQL, Points SQL, start vid, end vids, [driving side] [options]) + pgr_withPoints(Edges SQL, Points SQL, start vids, end vid, [driving side] [options]) + pgr_withPoints(Edges SQL, Points SQL, start vids, end vids, [driving side] [options]) + pgr_withPoints(Edges SQL, Points SQL, Combinations SQL, [driving side] [options]) + + options: [directed, details]) + + Returns set of (seq, path_seq, start_vid, end_vid, node, edge, cost, agg_cost) + OR EMPTY SET + +Exercise 2: Point routing +............................................................................... + +.. image:: images/withPoints/points_routing.png + :scale: 25% + :align: center + +.. rubric:: Problem + +Route from point **1** to point **2** on the ``vehicle_net`` where: + +* point **1**: (lat, lon) = (1, @POINT1_LAT@, @POINT1_LON@) +* point **2**: (lat, lon) = (2, @POINT2_LAT@, @POINT2_LON@) + +.. rubric:: Solution + +* The query from `Exercise 1: Get the nearest edge`_ is used as the inner query + for points. +* Using negative values to avoid conficts with vertices with the same value: + + * Routing from point **-1** to point **-2** + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :force: + :start-after: route_withPoints.txt + :end-before: wrk_withPoints.txt + +.. collapse:: Query results + + .. literalinclude:: ../scripts/basic/withPoints/route_withPoints.txt + +Exercise 3: Creating the point routing function +............................................................................... + +.. rubric:: Problem + +Create the function ``wrk_withPoints`` to route from locations using latitude +and longitude values. + +* Analyze the function. + +.. rubric:: Solution + +Creating a ``plpgsql`` function. + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :force: + :start-after: wrk_withPoints.txt + :end-before: use_fn_1.txt + +.. rubric:: Analysis + +The function's signature: + +* The input parameters instead of vertex identifiers, now it has the latitude + and longitude of a couple of points. +* The function returns the same set of values calculated on the + :doc:`sql_function`. + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :linenos: + :start-after: wrk_withPoints.txt + :end-before: signature ends + +Getting the closest query: + +* The query looks like the one on `Exercise 1: Get the nearest edge`_ +* Using PostgreSQL ``format`` to make substitutions. + + * The first parameter is the string to be replaced + * The rest are the data parameters, are the strings use for replacement. + * ``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively. + * ``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively. + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :force: + :linenos: + :start-after: -- 0 + :end-before: -- 1 + +Getting the routing results: + +* The query looks like the one on `Exercise 2: Point routing` +* Using PostgreSQL ``format`` to make substitutions. + + * The ``edges_subset`` value will replace ``%1$I``. + * The ``closest_query`` value will replace ``%2$s``. + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :force: + :linenos: + :start-after: -- 1 + :end-before: -- 2 + +Getting the additional information: + +* The subquery looks like the one in the function created on + :doc:`sql_function`. +* A joined table can not be a variable + + * Using PostgreSQL ``format`` to make substitutions. + * To make it work on the ``walk_net``, the whole query needs to be in + ``TEXT``. + * The ``edges_subset`` value will replace ``%1$I``: + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :force: + :linenos: + :start-after: -- 2 + :end-before: -- 3 + +Building the complete query: + +* The complete query looks like the one in the function created on + :doc:`sql_function`. +* Concatenation of strings is used. + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :force: + :linenos: + :start-after: -- 3 + :end-before: -- 4 + +Exercise 4: Using wrk_withPoints +............................................................................... + +.. image:: images/withPoints/points_routing.png + :scale: 25% + :align: center + +.. rubric:: Problem + +Use ``wrk_withPoints`` + +* Departure point is: (lat,lon) = ``(@POINT1_LAT@, @POINT1_LON@)`` +* Destination point is: (lat,lon) = ``(@POINT2_LAT@, @POINT2_LON@)`` +* For ``vehicle_net``: + + * Get the names of the streets of the route. + +* For ``taxi_net``: + + * Get the query that is been generated. + +* For ``walk_net``: + + * Use with default value of ``do_debug``. + * Store results on a table. + * Show the table contents. + +.. rubric:: Solution + +For ``vehicle_net``: + +* The first parameter is the table name. +* The next two parameters are the latitude and longitude of the departure point. +* The next two parameters are the latitude and longitude of the destination point. +* Use with default value of ``do_debug``. + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :start-after: use_fn_1.txt + :end-before: use_fn_2.txt + +.. collapse:: Query results + + .. literalinclude:: ../scripts/basic/withPoints/use_fn_1.txt + +For ``taxi_net``: + +* Do a dry run by adding ``true`` to get the query that is executed. + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :start-after: use_fn_2.txt + :end-before: use_fn_3.txt + +.. collapse:: Query results + + .. literalinclude:: ../scripts/basic/withPoints/warnings.txt + +For ``walk_net``: + +.. literalinclude:: ../scripts/basic/withPoints/withPoints.sql + :language: sql + :start-after: use_fn_3.txt + :end-before: \o + +.. collapse:: Query results + + .. literalinclude:: ../scripts/basic/withPoints/use_fn_3.txt diff --git a/docs/index.rst b/docs/index.rst index a81bbb279..4938fd44d 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -35,7 +35,7 @@ Basic basic/pedestrian.rst basic/vehicle.rst basic/sql_function.rst - basic/plpgsql_function.rst + basic/withPoints.rst United Nations Sustainable Development Goals =============================================================================== diff --git a/docs/scripts/basic/CMakeLists.txt b/docs/scripts/basic/CMakeLists.txt index 161a33fc1..dc43b9577 100644 --- a/docs/scripts/basic/CMakeLists.txt +++ b/docs/scripts/basic/CMakeLists.txt @@ -9,7 +9,7 @@ SET(PGR_WORKSHOP_DIR pedestrian vehicles sql_function - plpgsql_function + withPoints ) foreach (d ${PGR_WORKSHOP_DIR}) @@ -25,4 +25,4 @@ add_dependencies(basic_pedestrian_scripts basic_graphs_scripts) add_dependencies(basic_vehicles_scripts basic_graphs_scripts) add_dependencies(basic_sql_function_scripts basic_graphs_scripts) add_dependencies(basic_sql_function_scripts basic_vehicles_scripts) -add_dependencies(basic_plpgsql_function_scripts basic_sql_function_scripts) +add_dependencies(basic_withPoints_scripts basic_sql_function_scripts) diff --git a/docs/scripts/basic/plpgsql_function/CMakeLists.txt b/docs/scripts/basic/plpgsql_function/CMakeLists.txt deleted file mode 100644 index 9a210f0a8..000000000 --- a/docs/scripts/basic/plpgsql_function/CMakeLists.txt +++ /dev/null @@ -1,46 +0,0 @@ -add_custom_target(basic_plpgsql_function_scripts) - -#--------------------- -# Files -#--------------------- -configure_file(plpgsql_function.sql plpgsql_function.sql) - -#--------------------------------------------- -# Generating the results files -#--------------------------------------------- - -add_custom_command( - TARGET basic_plpgsql_function_scripts - PRE_BUILD - BYPRODUCTS - excercise-8_1_1.txt - excercise-8_1_2.txt - excercise-8_1_3.txt - excercise-8_1_4.txt - - excercise-8_2_1.txt - excercise-8_2_2.txt - excercise-8_2_3.txt - - excercise-8_3_1.txt - excercise-8_3_2.txt - excercise-8_3_3.txt - excercise-8_3_4.txt - - excercise-8_4.txt - - excercise-8_5_1.txt - excercise-8_5_2.txt - excercise-8_5_3.txt - excercise-8_5_4.txt - - excercise-8_6.txt - - excercise-8_7_1.txt - excercise-8_7_2.txt - excercise-8_7_3.txt - - warnings.txt - COMMAND psql -d city_routing -f plpgsql_function.sql 2> warnings.txt - COMMENT "running plpgsql_function scripts" - ) diff --git a/docs/scripts/basic/plpgsql_function/plpgsql_function.sql b/docs/scripts/basic/plpgsql_function/plpgsql_function.sql deleted file mode 100644 index 4776ada9e..000000000 --- a/docs/scripts/basic/plpgsql_function/plpgsql_function.sql +++ /dev/null @@ -1,207 +0,0 @@ -SELECT * -INTO points -FROM ( - SELECT 1 AS gid, ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) AS geom - UNION - SELECT 2, ST_SetSRID(ST_Point(@POINT2_LON@, @POINT2_LAT@), 4326) - ) AS info; - -\o created_points.txt - -SELECT * FROM points; - -\o views_vertices1.txt - -SELECT * INTO vehicle_net_vertices -FROM pgr_extractVertices( - 'SELECT id, source, target - FROM vehicle_net ORDER BY id'); - -UPDATE vehicle_net_vertices AS v -SET (x,y,geom) = (w.x, w.y, w.geom) -FROM ways_vertices AS w WHERE v.id = w.id; - -\o views_vertices2.txt -SELECT * INTO taxi_net_vertices -FROM pgr_extractVertices( - 'SELECT id, source, target - FROM taxi_net ORDER BY id'); - -UPDATE taxi_net_vertices AS v -SET (x,y,geom) = (w.x, w.y, w.geom) -FROM ways_vertices AS w WHERE v.id = w.id; -\o views_vertices3.txt -SELECT * INTO walk_net_vertices -FROM pgr_extractVertices( - 'SELECT id, source, target - FROM walk_net ORDER BY id'); - -UPDATE walk_net_vertices AS v -SET (x,y,geom) = (w.x, w.y, w.geom) -FROM ways_vertices AS w WHERE v.id = w.id; -\o exercise_8_3_1.txt - -SELECT id -FROM ways_vertices -ORDER BY geom <-> ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) -LIMIT 1; - -\o exercise_8_3_2.txt - -SELECT id -FROM vehicle_net_vertices -ORDER BY geom <-> ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) -LIMIT 1; - -\o exercise_8_3_3.txt - -SELECT id -FROM taxi_net_vertices -ORDER BY geom <-> ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) -LIMIT 1; - -\o exercise_8_3_4.txt - -SELECT id -FROM walk_net_vertices -ORDER BY geom <-> ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) -LIMIT 1; - -\o exercise_8_4.txt -CREATE OR REPLACE FUNCTION wrk_Nearest( - IN vertex_table REGCLASS, - IN lat NUMERIC, - IN lon NUMERIC) -RETURNS BIGINT AS -$BODY$ -DECLARE result BIGINT; -BEGIN - - EXECUTE format( - $$ - SELECT id - FROM %1$I - ORDER BY geom <-> ST_SetSRID(ST_Point(%3$s, %2$s), 4326) - LIMIT 1 - $$, - vertex_table, lat, lon) - INTO result; - RETURN result; - -END -$BODY$ -LANGUAGE 'plpgsql'; -\o exercise_8_5_1.txt - -SELECT wrk_Nearest('ways_vertices', @POINT1_LAT@, @POINT1_LON@); - -\o exercise_8_5_2.txt - -SELECT wrk_Nearest('vehicle_net_vertices', @POINT1_LAT@, @POINT1_LON@); - -\o exercise_8_5_3.txt - -SELECT wrk_Nearest('taxi_net_vertices', @POINT1_LAT@, @POINT1_LON@); - -\o exercise_8_5_4.txt - -SELECT wrk_Nearest('walk_net_vertices', @POINT1_LAT@, @POINT1_LON@); - -\o exercise_8_6.txt -CREATE OR REPLACE FUNCTION wrk_fromAtoB( - IN edges_subset REGCLASS, - IN lat1 NUMERIC, IN lon1 NUMERIC, - IN lat2 NUMERIC, IN lon2 NUMERIC, - IN do_debug BOOLEAN DEFAULT false, - - OUT seq INTEGER, - OUT id BIGINT, - OUT seconds FLOAT, - OUT name TEXT, - OUT length_m FLOAT, - OUT route_readable TEXT, - OUT route_geom geometry, - OUT azimuth FLOAT -) -RETURNS SETOF record AS --- signature ends -$BODY$ -DECLARE -final_query TEXT; -BEGIN - final_query := format( - $$ - SELECT * - FROM wrk_dijkstra( - '%1$I', - (SELECT wrk_Nearest('%1$I_vertices', %2$s, %3$s)), - (SELECT wrk_Nearest('%1$I_vertices', %4$s, %5$s)) - ) - $$, - -- Subtitutions on the query are in order - edges_subset, lat1, lon1, lat2, lon2); - - IF do_debug THEN - RAISE NOTICE '%', final_query; - RETURN; - END IF; - RETURN QUERY EXECUTE final_query; -END; -$BODY$ -LANGUAGE 'plpgsql'; -\o exercise_8_7_1.txt - -SELECT DISTINCT name -FROM wrk_fromAtoB( - 'vehicle_net', - @POINT1_LAT@, @POINT1_LON@, - @POINT2_LAT@, @POINT2_LON@); - -\o exercise_8_7_2.txt - -SELECT * -FROM wrk_fromAtoB( - 'taxi_net', - @POINT1_LAT@, @POINT1_LON@, - @POINT2_LAT@, @POINT2_LON@, - true); - -\o exercise_8_7_3.txt - -SELECT * -INTO example -FROM wrk_fromAtoB( - 'walk_net', - @POINT1_LAT@, @POINT1_LON@, - @POINT2_LAT@, @POINT2_LON@); - -SELECT * FROM example; - -\o - -WITH the_points AS ( -SELECT 1 AS id, ST_MakePoint(@POINT1_LON@, @POINT1_LAT@) -UNION -SELECT 1 AS id, ST_MakePoint(@POINT2_LON@, @POINT2_LAT@) -) -SELECT * INTO points_on_the_fly -FROM the_points; - -CREATE OR REPLACE VIEW ch8_using_vehicle AS -SELECT * FROM wrk_fromAtoB( - 'vehicle_net', - @POINT1_LAT@, @POINT1_LON@, - @POINT2_LAT@, @POINT2_LON@); - -CREATE OR REPLACE VIEW ch8_using_taxi AS -SELECT * FROM wrk_fromAtoB( - 'taxi_net', - @POINT1_LAT@, @POINT1_LON@, - @POINT2_LAT@, @POINT2_LON@); - -CREATE OR REPLACE VIEW ch8_using_walk AS -SELECT * -FROM wrk_fromAtoB( - 'walk_net', - @POINT1_LAT@, @POINT1_LON@, - @POINT2_LAT@, @POINT2_LON@); diff --git a/docs/scripts/basic/withPoints/CMakeLists.txt b/docs/scripts/basic/withPoints/CMakeLists.txt new file mode 100644 index 000000000..3049bb54b --- /dev/null +++ b/docs/scripts/basic/withPoints/CMakeLists.txt @@ -0,0 +1,29 @@ +#--------------------- +# Files +#--------------------- +configure_file(withPoints.sql withPoints.sql) +configure_file(images.sql images.sql) + +set(GENERATED_FILES + closestedges.txt + route_withPoints.txt + wrk_withPoints.txt + use_fn_1.txt + use_fn_2.txt + use_fn_3.txt + file_end.txt + warnings.txt +) + +add_custom_command( + COMMAND psql -d city_routing -f withPoints.sql 2> warnings.txt + COMMAND psql -d city_routing -f images.sql + OUTPUT ${GENERATED_FILES} + + DEPENDS withPoints.sql images.sql + COMMENT "running chapter withPoints scripts" +) + +add_custom_target(basic_withPoints_scripts + DEPENDS ${GENERATED_FILES} +) diff --git a/docs/scripts/basic/withPoints/images.sql b/docs/scripts/basic/withPoints/images.sql new file mode 100644 index 000000000..31cfe6202 --- /dev/null +++ b/docs/scripts/basic/withPoints/images.sql @@ -0,0 +1,42 @@ +DROP TABLE IF EXISTS points_on_map; +WITH the_points AS ( +SELECT 1 AS id, ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) +UNION +SELECT 2 AS id, ST_SetSRID(ST_Point(@POINT2_LON@, @POINT2_LAT@), 4326) +) +SELECT * INTO points_on_map +FROM the_points; + + +DROP TABLE IF EXISTS closest_walk; +WITH the_closest AS ( +SELECT 1 AS pid, * from pgr_findCloseEdges( + 'SELECT id, geom from walk_net', + ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) , 0.5) + +UNION + +SELECT 2 AS pid, * from pgr_findCloseEdges( + 'SELECT id, geom from walk_net', + ST_SetSRID(ST_Point(@POINT2_LON@, @POINT2_LAT@), 4326) , 0.5) +) +SELECT * INTO closest_walk FROM the_closest; + +CREATE OR REPLACE VIEW using_vehicle AS +SELECT * FROM wrk_withPoints( + 'vehicle_net', + @POINT1_LAT@, @POINT1_LON@, + @POINT2_LAT@, @POINT2_LON@); + +CREATE OR REPLACE VIEW using_taxi AS +SELECT * FROM wrk_withPoints( + 'taxi_net', + @POINT1_LAT@, @POINT1_LON@, + @POINT2_LAT@, @POINT2_LON@); + +CREATE OR REPLACE VIEW using_walk AS +SELECT * +FROM wrk_withPoints( + 'walk_net', + @POINT1_LAT@, @POINT1_LON@, + @POINT2_LAT@, @POINT2_LON@); diff --git a/docs/scripts/basic/withPoints/withPoints.sql b/docs/scripts/basic/withPoints/withPoints.sql new file mode 100644 index 000000000..1a74dfb53 --- /dev/null +++ b/docs/scripts/basic/withPoints/withPoints.sql @@ -0,0 +1,145 @@ +\o closestedges.txt + +SELECT 1 AS pid, * from pgr_findCloseEdges( + 'SELECT id, geom from vehicle_net', + ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326) , 0.5) + +UNION + +SELECT 2 AS pid, * from pgr_findCloseEdges( + 'SELECT id, geom from vehicle_net', + ST_SetSRID(ST_Point(@POINT2_LON@, @POINT2_LAT@), 4326) , 0.5); + + +\o route_withPoints.txt + +SELECT * FROM pgr_withPoints( + 'SELECT id, source, target, cost, reverse_cost from vehicle_net', + $$ + SELECT 2 AS pid, * from pgr_findCloseEdges( + 'SELECT id, geom from vehicle_net', + ST_SetSRID(ST_Point(@POINT1_LON@, @POINT1_LAT@), 4326), 0.5) + UNION + SELECT 1 AS pid, * from pgr_findCloseEdges( + 'SELECT id, geom from vehicle_net', + ST_SetSRID(ST_Point(@POINT2_LON@, @POINT2_LAT@), 4326), 0.5) + $$, + -1, -2); + +\o wrk_withPoints.txt +-- DROP FUNCTION wrk_withPoints(regclass, bigint, bigint); + +CREATE OR REPLACE FUNCTION wrk_withPoints( + IN edges_subset REGCLASS, + IN lat1 NUMERIC, IN lon1 NUMERIC, + IN lat2 NUMERIC, IN lon2 NUMERIC, + IN do_debug BOOLEAN DEFAULT false, + + OUT seq INTEGER, OUT id BIGINT, OUT seconds FLOAT, OUT name TEXT, OUT length FLOAT, + OUT route_readable TEXT, + OUT route_geom geometry, + OUT azimuth FLOAT +) +-- signature ends +RETURNS SETOF record AS +$BODY$ +DECLARE + closest_query TEXT; + resuts_query TEXT; + additional_query TEXT; + final_query TEXT; +BEGIN + -- 0 + + closest_query := format( + $cq$SELECT 1 AS pid, * from pgr_findCloseEdges( + $q1$ SELECT id, geom from %1$I $q1$, + ST_SetSRID(ST_Point(%2$s, %3$s), 4326) , 0.5) + + UNION + + SELECT 2 AS pid, * from pgr_findCloseEdges( + $q1$ SELECT id, geom from %1$I $q1$, + ST_SetSRID(ST_Point(%4$s, %5$s), 4326) , 0.5) + $cq$, edges_subset, lon1, lat1, lon2, lat2); + + -- 1 + + resuts_query := format( + $$SELECT seq, edge AS id, node, cost AS seconds + FROM pgr_withPoints( + 'SELECT * FROM %1$I', + '%2$s', + -1, -2) + $$, edges_subset, closest_query); + + -- 2 + + additional_query := format( + $$SELECT + seq, id, seconds, name, length, + CASE + WHEN node = source THEN ST_AsText(geom) + ELSE ST_AsText(ST_Reverse(geom)) + END AS readable, + + CASE + WHEN node = source THEN geom + ELSE ST_Reverse(geom) + END AS geom + FROM results + LEFT JOIN %1$I USING (id) + ORDER BY seq + $$, edges_subset); + + -- 3 + + final_query := + 'WITH + results AS (' || resuts_query || '), + additional AS ( ' || additional_query || ') + SELECT *, degrees(ST_azimuth(ST_StartPoint(geom), ST_EndPoint(geom))) AS azimuth + FROM additional ORDER BY seq'; + + -- 4 + + IF do_debug THEN + RAISE NOTICE '%', final_query; + RETURN; + END IF; + + RETURN QUERY EXECUTE final_query; + +END; +$BODY$ +LANGUAGE plpgsql; + +\o use_fn_1.txt + +SELECT DISTINCT name +FROM wrk_withPoints( + 'vehicle_net', + @POINT1_LAT@, @POINT1_LON@, + @POINT2_LAT@, @POINT2_LON@); + +\o use_fn_2.txt + +SELECT * +FROM wrk_withPoints( + 'taxi_net', + @POINT1_LAT@, @POINT1_LON@, + @POINT2_LAT@, @POINT2_LON@, + true); + +\o use_fn_3.txt + +SELECT * +INTO example +FROM wrk_withPoints( + 'walk_net', + @POINT1_LAT@, @POINT1_LON@, + @POINT2_LAT@, @POINT2_LON@); + +SELECT * FROM example; + +\o file_end.txt diff --git a/locale/en/LC_MESSAGES/basic/plpgsql_function.po b/locale/en/LC_MESSAGES/basic/plpgsql_function.po deleted file mode 100644 index 5973b8638..000000000 --- a/locale/en/LC_MESSAGES/basic/plpgsql_function.po +++ /dev/null @@ -1,729 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2010-2024 pgRouting Developers -# This file is distributed under the same license as the Workshop FOSS4G -# Belém package. -# FIRST AUTHOR , 2024. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: Workshop FOSS4G Belém 3.0\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-09-30 17:36+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" -"Language: en\n" -"Language-Team: en \n" -"Plural-Forms: nplurals=2; plural=(n != 1);\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.17.0\n" - -#: ../../build/docs/basic/plpgsql_function.rst:11 -msgid "pl/pgsql function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:17 -msgid "" -"Other kind of functions are `pl/pgsql `__. As the applications requirements become more " -"complex, using wrappers of previously defined functions becomes necessary " -"for clarity." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:22 -msgid "Chapter contents" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:25 -msgid "Requirements for routing from A to B" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:28 -msgid "Chapter problem:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:29 -msgid "" -"Create a function ``wrk_fromAtoB`` that allows routing from 2 geometries." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:30 -msgid "The function takes latitude/longitude points as input parameters." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:31 -msgid "" -"Returns a route that includes a geometry so that if can be displayed, for " -"example, in QGIS." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:32 -msgid "Will also return some other attributes." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:34 -msgid "The detailed description:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:37 -msgid "Input parameters" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:39 -msgid "Parameter" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:39 -#: ../../build/docs/basic/plpgsql_function.rst:204 -#: ../../build/docs/basic/plpgsql_function.rst:214 -msgid "type" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:39 -#: ../../build/docs/basic/plpgsql_function.rst:54 -#: ../../build/docs/basic/plpgsql_function.rst:204 -#: ../../build/docs/basic/plpgsql_function.rst:214 -msgid "Description" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:41 -msgid "``edges_subset``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:41 -#: ../../build/docs/basic/plpgsql_function.rst:206 -msgid "REGCLASS" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:41 -msgid "Edge table name identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:42 -msgid "``lat1``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:42 -#: ../../build/docs/basic/plpgsql_function.rst:43 -#: ../../build/docs/basic/plpgsql_function.rst:44 -#: ../../build/docs/basic/plpgsql_function.rst:45 -#: ../../build/docs/basic/plpgsql_function.rst:207 -#: ../../build/docs/basic/plpgsql_function.rst:208 -msgid "NUMERIC" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:42 -msgid "The latitude of the `departure` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:43 -msgid "``lon1``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:43 -msgid "The longitude of the `departure` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:44 -msgid "``lat2``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:44 -msgid "The latitude of the `destination` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:45 -msgid "``lon2``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:45 -msgid "The longitude of the `destination` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:46 -msgid "``do_debug``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:46 -msgid "BOOLEAN" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:46 -msgid "Flag to create a ``WARNING`` with the query that is been executed" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:52 -msgid "Output columns" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:54 -#: ../../build/docs/basic/plpgsql_function.rst:204 -msgid "Column" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:56 -msgid "``seq``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:56 -msgid "For ordering purposes." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:57 -msgid "``gid``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:57 -msgid "" -"The edge identifier that can be used to JOIN the results to the ``ways`` " -"table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:58 -msgid "``name``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:58 -msgid "The street name." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:59 -msgid "``azimuth``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:59 -msgid "Between start and end node of an edge." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:60 -msgid "``length``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:60 -msgid "In meters." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:61 -msgid "``minutes``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:61 -msgid "Minutes taken to traverse the segment." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:62 -msgid "``route_geom``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:62 -msgid "The road geometry with corrected directionality." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:66 -msgid "For this chapter, the following points will be used for testing." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:68 -msgid "(lat,lon) = (-36.8471438, 174.7710042)" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:69 -msgid "(lat,lon) = (-36.8524328, 174.766749)" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:72 -msgid "The Vertices Table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:74 -msgid "" -"Graphs have a `set of edges` and a `set of vertices` associated to it. The " -"views need their vertices table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:78 -msgid "Exercise 1: Create vertices table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:81 -#: ../../build/docs/basic/plpgsql_function.rst:128 -#: ../../build/docs/basic/plpgsql_function.rst:193 -#: ../../build/docs/basic/plpgsql_function.rst:256 -#: ../../build/docs/basic/plpgsql_function.rst:329 -#: ../../build/docs/basic/plpgsql_function.rst:405 -msgid "Problem" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:82 -msgid "Create a vertices table for the views:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:84 -msgid "``vehicle_net``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:85 -msgid "``taxi_net``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:86 -msgid "``walk_net``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:90 -#: ../../build/docs/basic/plpgsql_function.rst:141 -#: ../../build/docs/basic/plpgsql_function.rst:220 -#: ../../build/docs/basic/plpgsql_function.rst:273 -#: ../../build/docs/basic/plpgsql_function.rst:342 -#: ../../build/docs/basic/plpgsql_function.rst:428 -msgid "Solution" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:91 -msgid "" -"Use ``pgr_extractVertices`` (explained in :doc:`graphs`) to create the " -"vertices table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:93 -msgid "" -"``JOIN`` the vertices table with ``ways_vertices`` (created in :doc:" -"`graphs`) to get the ``x``, ``y``, ``geom`` information." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:96 -#: ../../build/docs/basic/plpgsql_function.rst:410 -#: ../../build/docs/basic/plpgsql_function.rst:429 -msgid "For ``vehicle_net``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:104 -#: ../../build/docs/basic/plpgsql_function.rst:414 -#: ../../build/docs/basic/plpgsql_function.rst:444 -msgid "For ``taxi_net``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:110 -#: ../../build/docs/basic/plpgsql_function.rst:418 -#: ../../build/docs/basic/plpgsql_function.rst:457 -msgid "For ``walk_net``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:112 -msgid "Modify the above queries to create the ``walk_net_vertices`` table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:120 -msgid "It is left to the reader to remove disconected components on the views." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:122 -msgid "See :doc:`graphs`" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:125 -msgid "Exercise 3: Nearest Vertex" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:129 -msgid "Calculate the (OSM) identifier of the nearest vertex to a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:131 -msgid "" -"In particular use the following (lat, lon) value: ``(-36.8471438, " -"174.7710042)``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:133 -#: ../../build/docs/basic/plpgsql_function.rst:265 -msgid "calculate the nearest OSM identifier of the vertex to:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:135 -#: ../../build/docs/basic/plpgsql_function.rst:267 -msgid "``ways_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:136 -#: ../../build/docs/basic/plpgsql_function.rst:268 -msgid "``vehicle_net_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:137 -#: ../../build/docs/basic/plpgsql_function.rst:269 -msgid "``taxi_net_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:138 -#: ../../build/docs/basic/plpgsql_function.rst:270 -msgid "``walk_net_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:142 -msgid "" -"Remember that the ``id`` has an OSM vertex identifier on the vertices tables." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:143 -msgid "" -"Using the Postgis distance operator `<-> `__ to order by distance." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:144 -msgid "Get only the first row, to obtain the nearest identifier of the vertex." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:146 -#: ../../build/docs/basic/plpgsql_function.rst:274 -msgid "For ``ways_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:157 -msgid "For ``vehicle_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:159 -#: ../../build/docs/basic/plpgsql_function.rst:174 -#: ../../build/docs/basic/plpgsql_function.rst:182 -#: ../../build/docs/basic/plpgsql_function.rst:293 -#: ../../build/docs/basic/plpgsql_function.rst:306 -msgid "Modify the previous query." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:172 -#: ../../build/docs/basic/plpgsql_function.rst:304 -msgid "For ``taxi_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:180 -#: ../../build/docs/basic/plpgsql_function.rst:312 -msgid "For ``walk_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:190 -msgid "Exercise 4: Nearest vertex function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:194 -msgid "" -"When operations look similar for different tables, a function can be created." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:196 -msgid "" -"Create a function that calculates the OSM identifier of the nearest vertex " -"to a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:197 -msgid "Function name: ``wrk_nearest``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:198 -msgid "Needs to work only for the **final application** views and table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:201 -msgid "The input parameters:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:206 -msgid "vertex_table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:206 -msgid "Table name identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:207 -msgid "lat" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:207 -msgid "The latitude of a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:208 -msgid "lon" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:208 -msgid "The longitude of a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:211 -msgid "The output:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:216 -msgid "BIGINT" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:216 -msgid "the OSM identifier that is nearest to (lat,lon)." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:221 -msgid "The function returns only one ``BIGINT`` value." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:222 -msgid "" -"Using `format `__ to build the query." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:226 -msgid "" -"The structure of the query is similar to `Exercise 3: Nearest Vertex`_ " -"solutions." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:228 -msgid "``%1$I`` for the table name identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:229 -msgid "``%2$s`` and ``%3$s`` for the latitude and longitude." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:231 -msgid "The point is formed with (lon/lat) ``(%3$s, %2$s)``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:241 -msgid "Exercise 5: Test nearest vertex function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:243 -msgid "Nearest Vertex in vehicle network" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:247 -msgid "Nearest Vertex in taxi network" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:251 -msgid "Nearest Vertex in walk network" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:257 -msgid "Test the ``wrk_Nearest`` function." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:259 -msgid "Use the following (lat,lon) values: ``(-36.8471438, 174.7710042)``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:261 -msgid "The point is the same as in `Exercise 3: Nearest Vertex`_ problem." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:263 -msgid "Verify the results are the same." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:276 -msgid "" -"Use the function with ``ways_vertices`` as the ``vertex_table`` parameter." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:277 -msgid "Pass the (lat,lon) values as second and third parameters." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:278 -msgid "" -"Using the function on the original data does not return the OSM identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:280 -msgid "The value stored in ``id`` column is not the OSM identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:291 -msgid "For ``vehicles_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:320 -msgid "wrk_fromAtoB function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:322 -msgid "" -"In this section, creation and testing the required function will be tackled." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:326 -msgid "Exercise 6: Creating the main function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:330 -msgid "Create the function ``wrk_fromAtoB``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:331 -msgid "" -"Follow the description given at `Requirements for routing from A to B`_." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:332 -msgid "Use specialized functions:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:334 -msgid "``wrk_NearestOSM`` created on `Exercise 4: Nearest vertex function`_." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:336 -msgid "It receives the point in natural language format." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:337 -msgid "Obtains the OSM identifier needed by ``wrk_dijkstra``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:339 -msgid "``wrk_dijkstra`` created in :doc:`sql_function`" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:343 -msgid "The function's signature:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:345 -msgid "The input parameters highlighted." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:346 -msgid "The output columns are not highlighted." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:347 -msgid "The function returns a set of values." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:357 -msgid "The function's body:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:359 -msgid "Call to the function ``wrk_dijkstra``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:361 -msgid "Using PostgreSQL ``format`` to make substitutions" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:363 -msgid "The first parameter is the string to be replaced" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:364 -msgid "The rest are the data parameters, are the strings use for replacement." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:366 -msgid "``wrk_dijkstra`` obtains the values for the output" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:367 -msgid "The ``edges_subset`` value will replace ``%1$I``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:368 -msgid "For the ``source`` and ``target``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:370 -msgid "``wrk_Nearest`` is used to find the identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:372 -msgid "The vertices table name is formed with ``%1$I_vertices``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:374 -msgid "``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:375 -msgid "``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:377 -msgid "To get the constructed query in form of a warning:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:379 -msgid "The ``WARNING`` will be issued only when ``do_debug`` is true." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:380 -msgid "No output will be generated." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:398 -msgid "Exercise 7: Using the main function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:400 -msgid "View of roads for taxis along with source and destination" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:406 -msgid "Use ``wrk_fromAtoB``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:408 -msgid "Departure point is: (lat,lon) = ``(-36.8471438, 174.7710042)``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:409 -msgid "Destination point is: (lat,lon) = ``(-36.8524328, 174.766749)``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:412 -#: ../../build/docs/basic/plpgsql_function.rst:420 -msgid "Use with default value of ``do_debug``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:416 -msgid "Use with ``do_debug`` set to ``true``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:421 -msgid "Store results on a table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:422 -msgid "Show the table contents." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:425 -msgid "The function is not meant to be used with ``ways``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:431 -msgid "The first parameter is the table name." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:432 -msgid "" -"The next two parameters are the latitude and longitude of the departure " -"point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:433 -msgid "" -"The next two parameters are the latitude and longitude of the destination " -"point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:446 -msgid "Do a dry run by adding ``true`` to get the query that is executed." -msgstr "" diff --git a/locale/en/LC_MESSAGES/basic/sql_function.po b/locale/en/LC_MESSAGES/basic/sql_function.po index 717fe1ad4..99b6f5b07 100644 --- a/locale/en/LC_MESSAGES/basic/sql_function.po +++ b/locale/en/LC_MESSAGES/basic/sql_function.po @@ -226,7 +226,7 @@ msgid "``length``" msgstr "" #: ../../build/docs/basic/sql_function.rst:74 -msgid "The leng in meters of the segment." +msgid "The length in meters of the segment." msgstr "" #: ../../build/docs/basic/sql_function.rst:75 diff --git a/locale/en/LC_MESSAGES/basic/withPoints.po b/locale/en/LC_MESSAGES/basic/withPoints.po new file mode 100644 index 000000000..5ed5962ea --- /dev/null +++ b/locale/en/LC_MESSAGES/basic/withPoints.po @@ -0,0 +1,579 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2010-2024 pgRouting Developers +# This file is distributed under the same license as the Workshop FOSS4G +# Belém package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Workshop FOSS4G Belém 3.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-10-07 15:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: en\n" +"Language-Team: en \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.17.0\n" + +#: ../../build/docs/basic/withPoints.rst:11 +msgid "Routing using points" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:17 +msgid "" +"Other kind of functions are `pl/pgsql `__. As the applications requirements become more " +"complex, building queries and storing queries in a variable becomes necessary" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:22 +msgid "pgRouting functions in this chapter" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:24 +msgid "`pgr_findCloseEdges`_" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:25 +msgid "`pgr_withPoints`_" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:27 +msgid "Chapter contents" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:30 +msgid "Requirements for routing lat,lon points" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:33 +msgid "Chapter problem:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:34 +msgid "" +"Create a function ``wrk_withPoints`` that allows routing from two point " +"geometries and works for" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:37 +msgid "``vehicle_net``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:38 +msgid "``taxi_net``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:39 +msgid "``walk_net``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:41 +msgid "The function takes as input parameters:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:43 +msgid "The edges table name" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:44 +msgid "Latitude/longitude of two point" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:46 +msgid "Returns" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:48 +msgid "the same information as in :doc:`sql_function` chapter problem." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:49 +msgid "or the query that it builds" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:52 +msgid "The detailed description:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:55 +msgid "Input parameters" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:57 +msgid "Parameter" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:57 +msgid "type" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:57 +#: ../../build/docs/basic/withPoints.rst:72 +msgid "Description" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:59 +msgid "``edges_subset``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:59 +msgid "REGCLASS" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:59 +msgid "Edge table name identifier." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:60 +msgid "``lat1``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:60 +#: ../../build/docs/basic/withPoints.rst:61 +#: ../../build/docs/basic/withPoints.rst:62 +#: ../../build/docs/basic/withPoints.rst:63 +msgid "NUMERIC" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:60 +msgid "The latitude of the `departure` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:61 +msgid "``lon1``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:61 +msgid "The longitude of the `departure` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:62 +msgid "``lat2``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:62 +msgid "The latitude of the `destination` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:63 +msgid "``lon2``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:63 +msgid "The longitude of the `destination` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:64 +msgid "``do_debug``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:64 +msgid "BOOLEAN" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:64 +msgid "Flag to create a ``NOTICE`` with the query that is been executed" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:70 +msgid "Output columns" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:72 +msgid "Name" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:72 +msgid "Type" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:74 +msgid "``seq``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:74 +msgid "INTEGER" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:74 +msgid "A unique number for each result row." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:75 +msgid "``id``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:75 +msgid "BIGINT" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:75 +msgid "The edge identifier." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:76 +msgid "``name``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:76 +#: ../../build/docs/basic/withPoints.rst:80 +msgid "TEXT" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:76 +msgid "The name of the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:77 +msgid "``seconds``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:77 +#: ../../build/docs/basic/withPoints.rst:78 +#: ../../build/docs/basic/withPoints.rst:79 +msgid "FLOAT" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:77 +msgid "The number of seconds it takes to traverse the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:78 +msgid "``length``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:78 +msgid "The length in meters of the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:79 +msgid "``azimuth``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:79 +msgid "The azimuth of the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:80 +msgid "``route_readable``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:80 +msgid "The geometry in human readable form." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:81 +msgid "``route_geom``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:81 +msgid "geometry" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:81 +msgid "The geometry of the segment in the correct direction." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:85 +msgid "For this chapter, the following points will be used for testing." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:87 +msgid "(lat,lon) = (-36.850329, 174.763094)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:88 +msgid "(lat,lon) = (-36.853675, 174.764448)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:91 +msgid "pgr_findCloseEdges" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:93 +msgid "Finds the close edges to a point geometry." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:96 +#: ../../build/docs/basic/withPoints.rst:143 +msgid "Signature Summary" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:108 +msgid "Exercise 1: Get the nearest edge" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:115 +#: ../../build/docs/basic/withPoints.rst:165 +#: ../../build/docs/basic/withPoints.rst:193 +#: ../../build/docs/basic/withPoints.rst:295 +msgid "Problem" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:116 +msgid "Get the nearest edge on the graph of the following points." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:118 +msgid "(pid, lat, lon) = (1, -36.850329, 174.763094)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:119 +msgid "(pid, lat, lon) = (2, -36.853675, 174.764448)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:122 +#: ../../build/docs/basic/withPoints.rst:172 +#: ../../build/docs/basic/withPoints.rst:200 +#: ../../build/docs/basic/withPoints.rst:315 +msgid "Solution" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:123 +msgid "" +"Build the geometry of the points with the appropiate SRID. (lines **4** and " +"**10**)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:125 +msgid "Get the union of the individual queries" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:138 +msgid "pgr_withPoints" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:140 +msgid "" +"Returns the shortest path in a graph with additional temporary vertices." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:158 +msgid "Exercise 2: Point routing" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:166 +msgid "Route from point **1** to point **2** on the ``vehicle_net`` where:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:168 +msgid "point **1**: (lat, lon) = (1, -36.850329, 174.763094)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:169 +msgid "point **2**: (lat, lon) = (2, -36.853675, 174.764448)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:173 +msgid "" +"The query from `Exercise 1: Get the nearest edge`_ is used as the inner " +"query for points." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:175 +msgid "" +"Using negative values to avoid conficts with vertices with the same value:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:177 +msgid "Routing from point **-1** to point **-2**" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:190 +msgid "Exercise 3: Creating the point routing function" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:194 +msgid "" +"Create the function ``wrk_withPoints`` to route from locations using " +"latitude and longitude values." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:197 +msgid "Analyze the function." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:201 +msgid "Creating a ``plpgsql`` function." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:210 +msgid "Analysis" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:211 +msgid "The function's signature:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:213 +msgid "" +"The input parameters instead of vertex identifiers, now it has the latitude " +"and longitude of a couple of points." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:215 +msgid "" +"The function returns the same set of values calculated on the :doc:" +"`sql_function`." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:224 +msgid "Getting the closest query:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:226 +msgid "The query looks like the one on `Exercise 1: Get the nearest edge`_" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:227 +#: ../../build/docs/basic/withPoints.rst:244 +#: ../../build/docs/basic/withPoints.rst:262 +msgid "Using PostgreSQL ``format`` to make substitutions." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:229 +msgid "The first parameter is the string to be replaced" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:230 +msgid "The rest are the data parameters, are the strings use for replacement." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:231 +msgid "``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:232 +msgid "``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:241 +msgid "Getting the routing results:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:243 +msgid "The query looks like the one on `Exercise 2: Point routing`" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:246 +msgid "The ``edges_subset`` value will replace ``%1$I``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:247 +msgid "The ``closest_query`` value will replace ``%2$s``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:256 +msgid "Getting the additional information:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:258 +msgid "" +"The subquery looks like the one in the function created on :doc:" +"`sql_function`." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:260 +msgid "A joined table can not be a variable" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:263 +msgid "" +"To make it work on the ``walk_net``, the whole query needs to be in ``TEXT``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:265 +msgid "The ``edges_subset`` value will replace ``%1$I``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:274 +msgid "Building the complete query:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:276 +msgid "" +"The complete query looks like the one in the function created on :doc:" +"`sql_function`." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:278 +msgid "Concatenation of strings is used." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:288 +msgid "Exercise 4: Using wrk_withPoints" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:296 +msgid "Use ``wrk_withPoints``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:298 +msgid "Departure point is: (lat,lon) = ``(-36.850329, 174.763094)``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:299 +msgid "Destination point is: (lat,lon) = ``(-36.853675, 174.764448)``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:300 +#: ../../build/docs/basic/withPoints.rst:316 +msgid "For ``vehicle_net``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:302 +msgid "Get the names of the streets of the route." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:304 +#: ../../build/docs/basic/withPoints.rst:332 +msgid "For ``taxi_net``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:306 +msgid "Get the query that is been generated." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:308 +#: ../../build/docs/basic/withPoints.rst:345 +msgid "For ``walk_net``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:310 +#: ../../build/docs/basic/withPoints.rst:321 +msgid "Use with default value of ``do_debug``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:311 +msgid "Store results on a table." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:312 +msgid "Show the table contents." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:318 +msgid "The first parameter is the table name." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:319 +msgid "" +"The next two parameters are the latitude and longitude of the departure " +"point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:320 +msgid "" +"The next two parameters are the latitude and longitude of the destination " +"point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:334 +msgid "Do a dry run by adding ``true`` to get the query that is executed." +msgstr "" diff --git a/locale/es/LC_MESSAGES/basic/sql_function.po b/locale/es/LC_MESSAGES/basic/sql_function.po index 66dc0b406..37cccc93e 100644 --- a/locale/es/LC_MESSAGES/basic/sql_function.po +++ b/locale/es/LC_MESSAGES/basic/sql_function.po @@ -231,7 +231,7 @@ msgid "``length``" msgstr "``length``" #: ../../build/docs/basic/sql_function.rst:67 -msgid "The leng in meters of the segment." +msgid "The length in meters of the segment." msgstr "Longitud en metros del segmento." #: ../../build/docs/basic/sql_function.rst:68 diff --git a/locale/es/LC_MESSAGES/basic/plpgsql_function.po b/locale/es/LC_MESSAGES/basic/withPoints.po similarity index 63% rename from locale/es/LC_MESSAGES/basic/plpgsql_function.po rename to locale/es/LC_MESSAGES/basic/withPoints.po index f56162578..a0631089d 100644 --- a/locale/es/LC_MESSAGES/basic/plpgsql_function.po +++ b/locale/es/LC_MESSAGES/basic/withPoints.po @@ -16,7 +16,7 @@ msgstr "" "PO-Revision-Date: 2024-12-16 19:42+0000\n" "Last-Translator: Celia Virginia Vergara Castillo \n" "Language-Team: Spanish \n" +"pgrouting-workshop/basic-withPoints/es/>\n" "Language: es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" @@ -25,11 +25,11 @@ msgstr "" "X-Generator: Weblate 5.4.3\n" "Generated-By: Babel 2.16.0\n" -#: ../../build/docs/basic/plpgsql_function.rst:11 +#: ../../build/docs/basic/withPoints.rst:11 msgid "pl/pgsql function" msgstr "Función pl/pgsql" -#: ../../build/docs/basic/plpgsql_function.rst:17 +#: ../../build/docs/basic/withPoints.rst:17 msgid "" "Other kind of functions are `pl/pgsql " "`__. As the " @@ -42,27 +42,27 @@ msgstr "" "envoltorios de funciones previamente definidas se hacen necesarios para " "mayor claridad." -#: ../../build/docs/basic/plpgsql_function.rst:22 +#: ../../build/docs/basic/withPoints.rst:22 msgid "Chapter contents" msgstr "Contenido del capítulo" -#: ../../build/docs/basic/plpgsql_function.rst:25 +#: ../../build/docs/basic/withPoints.rst:25 msgid "Requirements for routing from A to B" msgstr "Requisitos para el ruteo de A a B" -#: ../../build/docs/basic/plpgsql_function.rst:28 +#: ../../build/docs/basic/withPoints.rst:28 msgid "Chapter problem:" msgstr "Problema del capítulo:" -#: ../../build/docs/basic/plpgsql_function.rst:29 +#: ../../build/docs/basic/withPoints.rst:29 msgid "Create a function ``wrk_fromAtoB`` that allows routing from 2 geometries." msgstr "Cree una función ``wrk_fromAtoB`` que permita el ruteo desde 2 geometrías." -#: ../../build/docs/basic/plpgsql_function.rst:30 +#: ../../build/docs/basic/withPoints.rst:30 msgid "The function takes latitude/longitude points as input parameters." msgstr "La función toma los puntos de latitud/longitud como parámetros de entrada." -#: ../../build/docs/basic/plpgsql_function.rst:31 +#: ../../build/docs/basic/withPoints.rst:31 msgid "" "Returns a route that includes a geometry so that if can be displayed, for" " example, in QGIS." @@ -70,123 +70,123 @@ msgstr "" "Devuelve una ruta que incluye una geometría para que si se puede " "desplegar, por ejemplo, en QGIS." -#: ../../build/docs/basic/plpgsql_function.rst:32 +#: ../../build/docs/basic/withPoints.rst:32 msgid "Will also return some other attributes." msgstr "También devolverá algunos otros atributos." -#: ../../build/docs/basic/plpgsql_function.rst:34 +#: ../../build/docs/basic/withPoints.rst:34 msgid "The detailed description:" msgstr "La descripción detallada:" -#: ../../build/docs/basic/plpgsql_function.rst:37 +#: ../../build/docs/basic/withPoints.rst:37 msgid "Input parameters" msgstr "Parámetros de entrada" -#: ../../build/docs/basic/plpgsql_function.rst:39 +#: ../../build/docs/basic/withPoints.rst:39 msgid "Parameter" msgstr "Parámetro" -#: ../../build/docs/basic/plpgsql_function.rst:39 -#: ../../build/docs/basic/plpgsql_function.rst:204 -#: ../../build/docs/basic/plpgsql_function.rst:214 +#: ../../build/docs/basic/withPoints.rst:39 +#: ../../build/docs/basic/withPoints.rst:204 +#: ../../build/docs/basic/withPoints.rst:214 msgid "type" msgstr "tipo" -#: ../../build/docs/basic/plpgsql_function.rst:39 -#: ../../build/docs/basic/plpgsql_function.rst:54 -#: ../../build/docs/basic/plpgsql_function.rst:204 -#: ../../build/docs/basic/plpgsql_function.rst:214 +#: ../../build/docs/basic/withPoints.rst:39 +#: ../../build/docs/basic/withPoints.rst:54 +#: ../../build/docs/basic/withPoints.rst:204 +#: ../../build/docs/basic/withPoints.rst:214 msgid "Description" msgstr "Descripción" -#: ../../build/docs/basic/plpgsql_function.rst:41 +#: ../../build/docs/basic/withPoints.rst:41 msgid "``edges_subset``" msgstr "``edges_subset``" -#: ../../build/docs/basic/plpgsql_function.rst:41 -#: ../../build/docs/basic/plpgsql_function.rst:206 +#: ../../build/docs/basic/withPoints.rst:41 +#: ../../build/docs/basic/withPoints.rst:206 msgid "REGCLASS" msgstr "REGCLASS" -#: ../../build/docs/basic/plpgsql_function.rst:41 +#: ../../build/docs/basic/withPoints.rst:41 msgid "Edge table name identifier." msgstr "Identificador de nombre de tabla perimetral." -#: ../../build/docs/basic/plpgsql_function.rst:42 +#: ../../build/docs/basic/withPoints.rst:42 msgid "``lat1``" msgstr "``lat1``" -#: ../../build/docs/basic/plpgsql_function.rst:42 -#: ../../build/docs/basic/plpgsql_function.rst:43 -#: ../../build/docs/basic/plpgsql_function.rst:44 -#: ../../build/docs/basic/plpgsql_function.rst:45 -#: ../../build/docs/basic/plpgsql_function.rst:207 -#: ../../build/docs/basic/plpgsql_function.rst:208 +#: ../../build/docs/basic/withPoints.rst:42 +#: ../../build/docs/basic/withPoints.rst:43 +#: ../../build/docs/basic/withPoints.rst:44 +#: ../../build/docs/basic/withPoints.rst:45 +#: ../../build/docs/basic/withPoints.rst:207 +#: ../../build/docs/basic/withPoints.rst:208 msgid "NUMERIC" msgstr "NUMERIC" -#: ../../build/docs/basic/plpgsql_function.rst:42 +#: ../../build/docs/basic/withPoints.rst:42 msgid "The latitude of the `departure` point." msgstr "La latitud del punto de `partida`." -#: ../../build/docs/basic/plpgsql_function.rst:43 +#: ../../build/docs/basic/withPoints.rst:43 msgid "``lon1``" msgstr "``lon1``" -#: ../../build/docs/basic/plpgsql_function.rst:43 +#: ../../build/docs/basic/withPoints.rst:43 msgid "The longitude of the `departure` point." msgstr "La longitud del punto de `partida`." -#: ../../build/docs/basic/plpgsql_function.rst:44 +#: ../../build/docs/basic/withPoints.rst:44 msgid "``lat2``" msgstr "``lat2``" -#: ../../build/docs/basic/plpgsql_function.rst:44 +#: ../../build/docs/basic/withPoints.rst:44 msgid "The latitude of the `destination` point." msgstr "La latitud del punto de `destino`." -#: ../../build/docs/basic/plpgsql_function.rst:45 +#: ../../build/docs/basic/withPoints.rst:45 msgid "``lon2``" msgstr "``lon2``" -#: ../../build/docs/basic/plpgsql_function.rst:45 +#: ../../build/docs/basic/withPoints.rst:45 msgid "The longitude of the `destination` point." msgstr "La longitud del punto de `destino`." -#: ../../build/docs/basic/plpgsql_function.rst:46 +#: ../../build/docs/basic/withPoints.rst:46 msgid "``do_debug``" msgstr "``do_debug``" -#: ../../build/docs/basic/plpgsql_function.rst:46 +#: ../../build/docs/basic/withPoints.rst:46 msgid "BOOLEAN" msgstr "BOOLEAN" -#: ../../build/docs/basic/plpgsql_function.rst:46 +#: ../../build/docs/basic/withPoints.rst:46 msgid "Flag to create a ``WARNING`` with the query that is been executed" msgstr "Marcar para crear una ``ADVERTENCIA`` con la consulta que se ha ejecutado" -#: ../../build/docs/basic/plpgsql_function.rst:52 +#: ../../build/docs/basic/withPoints.rst:52 msgid "Output columns" msgstr "Columnas de resultados" -#: ../../build/docs/basic/plpgsql_function.rst:54 -#: ../../build/docs/basic/plpgsql_function.rst:204 +#: ../../build/docs/basic/withPoints.rst:54 +#: ../../build/docs/basic/withPoints.rst:204 msgid "Column" msgstr "Columna" -#: ../../build/docs/basic/plpgsql_function.rst:56 +#: ../../build/docs/basic/withPoints.rst:56 msgid "``seq``" msgstr "``seq``" -#: ../../build/docs/basic/plpgsql_function.rst:56 +#: ../../build/docs/basic/withPoints.rst:56 msgid "For ordering purposes." msgstr "Para fines ordenamiento." -#: ../../build/docs/basic/plpgsql_function.rst:57 +#: ../../build/docs/basic/withPoints.rst:57 msgid "``gid``" msgstr "``gid``" -#: ../../build/docs/basic/plpgsql_function.rst:57 +#: ../../build/docs/basic/withPoints.rst:57 msgid "" "The edge identifier that can be used to JOIN the results to the ``ways`` " "table." @@ -194,63 +194,63 @@ msgstr "" "Identificador de bordes que se puede utilizar para unir los resultados a " "la tabla ``ways``." -#: ../../build/docs/basic/plpgsql_function.rst:58 +#: ../../build/docs/basic/withPoints.rst:58 msgid "``name``" msgstr "``name``" -#: ../../build/docs/basic/plpgsql_function.rst:58 +#: ../../build/docs/basic/withPoints.rst:58 msgid "The street name." msgstr "El nombre de la calle." -#: ../../build/docs/basic/plpgsql_function.rst:59 +#: ../../build/docs/basic/withPoints.rst:59 msgid "``azimuth``" msgstr "``azimuth``" -#: ../../build/docs/basic/plpgsql_function.rst:59 +#: ../../build/docs/basic/withPoints.rst:59 msgid "Between start and end node of an edge." msgstr "Entre el nodo inicial y final de una arista." -#: ../../build/docs/basic/plpgsql_function.rst:60 +#: ../../build/docs/basic/withPoints.rst:60 msgid "``length``" msgstr "``length``" -#: ../../build/docs/basic/plpgsql_function.rst:60 +#: ../../build/docs/basic/withPoints.rst:60 msgid "In meters." msgstr "En metros." -#: ../../build/docs/basic/plpgsql_function.rst:61 +#: ../../build/docs/basic/withPoints.rst:61 msgid "``minutes``" msgstr "``minutes``" -#: ../../build/docs/basic/plpgsql_function.rst:61 +#: ../../build/docs/basic/withPoints.rst:61 msgid "Minutes taken to traverse the segment." msgstr "Minutos tomados para atravesar el segmento." -#: ../../build/docs/basic/plpgsql_function.rst:62 +#: ../../build/docs/basic/withPoints.rst:62 msgid "``route_geom``" msgstr "``route_geom``" -#: ../../build/docs/basic/plpgsql_function.rst:62 +#: ../../build/docs/basic/withPoints.rst:62 msgid "The road geometry with corrected directionality." msgstr "La geometría de la carretera con direccionalidad corregida." -#: ../../build/docs/basic/plpgsql_function.rst:66 +#: ../../build/docs/basic/withPoints.rst:66 msgid "For this chapter, the following points will be used for testing." msgstr "Para este capítulo, se utilizarán los siguientes puntos para las pruebas." -#: ../../build/docs/basic/plpgsql_function.rst:68 +#: ../../build/docs/basic/withPoints.rst:68 msgid "(lat,lon) = (-1.455829, -48.446044)" msgstr "(lat,lon) = (-1.455829, -48.446044)" -#: ../../build/docs/basic/plpgsql_function.rst:69 +#: ../../build/docs/basic/withPoints.rst:69 msgid "(lat,lon) = (-1.453448, -48.447142)" msgstr "(lat,lon) = (-1.453448, -48.447142)" -#: ../../build/docs/basic/plpgsql_function.rst:72 +#: ../../build/docs/basic/withPoints.rst:72 msgid "The Vertices Table" msgstr "La Tabla de Vértices" -#: ../../build/docs/basic/plpgsql_function.rst:74 +#: ../../build/docs/basic/withPoints.rst:74 msgid "" "Graphs have a `set of edges` and a `set of vertices` associated to it. " "The views need their vertices table." @@ -258,45 +258,45 @@ msgstr "" "Los grafos tienen un `conjunto de aristas` y un `conjunto de vértices` " "asociados a él. Las vistas necesitan su tabla de vértices." -#: ../../build/docs/basic/plpgsql_function.rst:78 +#: ../../build/docs/basic/withPoints.rst:78 msgid "Exercise 1: Create vertices table" msgstr "Ejercicio 1: Crear la tabla de vértices" -#: ../../build/docs/basic/plpgsql_function.rst:81 -#: ../../build/docs/basic/plpgsql_function.rst:128 -#: ../../build/docs/basic/plpgsql_function.rst:193 -#: ../../build/docs/basic/plpgsql_function.rst:256 -#: ../../build/docs/basic/plpgsql_function.rst:329 -#: ../../build/docs/basic/plpgsql_function.rst:405 +#: ../../build/docs/basic/withPoints.rst:81 +#: ../../build/docs/basic/withPoints.rst:128 +#: ../../build/docs/basic/withPoints.rst:193 +#: ../../build/docs/basic/withPoints.rst:256 +#: ../../build/docs/basic/withPoints.rst:329 +#: ../../build/docs/basic/withPoints.rst:405 msgid "Problem" msgstr "Problema" -#: ../../build/docs/basic/plpgsql_function.rst:82 +#: ../../build/docs/basic/withPoints.rst:82 msgid "Create a vertices table for the views:" msgstr "Crear una tabla de vértices:" -#: ../../build/docs/basic/plpgsql_function.rst:84 +#: ../../build/docs/basic/withPoints.rst:84 msgid "``vehicle_net``" msgstr "``vehicle_net``" -#: ../../build/docs/basic/plpgsql_function.rst:85 +#: ../../build/docs/basic/withPoints.rst:85 msgid "``taxi_net``" msgstr "``taxi_net``" -#: ../../build/docs/basic/plpgsql_function.rst:86 +#: ../../build/docs/basic/withPoints.rst:86 msgid "``walk_net``" msgstr "``walk_net``" -#: ../../build/docs/basic/plpgsql_function.rst:90 -#: ../../build/docs/basic/plpgsql_function.rst:141 -#: ../../build/docs/basic/plpgsql_function.rst:220 -#: ../../build/docs/basic/plpgsql_function.rst:273 -#: ../../build/docs/basic/plpgsql_function.rst:342 -#: ../../build/docs/basic/plpgsql_function.rst:428 +#: ../../build/docs/basic/withPoints.rst:90 +#: ../../build/docs/basic/withPoints.rst:141 +#: ../../build/docs/basic/withPoints.rst:220 +#: ../../build/docs/basic/withPoints.rst:273 +#: ../../build/docs/basic/withPoints.rst:342 +#: ../../build/docs/basic/withPoints.rst:428 msgid "Solution" msgstr "Solución" -#: ../../build/docs/basic/plpgsql_function.rst:91 +#: ../../build/docs/basic/withPoints.rst:91 msgid "" "Use ``pgr_extractVertices`` (explained in :doc:`graphs`) to create " "the vertices table" @@ -304,7 +304,7 @@ msgstr "" "Utilizar ``pgr_extractVertices`` (explicado en :doc:`graphs`) para " "crear la tabla de vértices" -#: ../../build/docs/basic/plpgsql_function.rst:93 +#: ../../build/docs/basic/withPoints.rst:93 msgid "" "``JOIN`` the vertices table with ``ways_vertices`` (created in " ":doc:`graphs`) to get the ``x``, ``y``, ``geom`` information." @@ -313,49 +313,49 @@ msgstr "" ":doc:`graphs`) para obtener la información de ``x``, ``y``, " "``geom``." -#: ../../build/docs/basic/plpgsql_function.rst:96 -#: ../../build/docs/basic/plpgsql_function.rst:410 -#: ../../build/docs/basic/plpgsql_function.rst:429 +#: ../../build/docs/basic/withPoints.rst:96 +#: ../../build/docs/basic/withPoints.rst:410 +#: ../../build/docs/basic/withPoints.rst:429 msgid "For ``vehicle_net``:" msgstr "Para ``vehicle_net``:" -#: ../../build/docs/basic/plpgsql_function.rst:104 -#: ../../build/docs/basic/plpgsql_function.rst:414 -#: ../../build/docs/basic/plpgsql_function.rst:444 +#: ../../build/docs/basic/withPoints.rst:104 +#: ../../build/docs/basic/withPoints.rst:414 +#: ../../build/docs/basic/withPoints.rst:444 msgid "For ``taxi_net``:" msgstr "Para ``taxi_net``:" -#: ../../build/docs/basic/plpgsql_function.rst:110 -#: ../../build/docs/basic/plpgsql_function.rst:418 -#: ../../build/docs/basic/plpgsql_function.rst:457 +#: ../../build/docs/basic/withPoints.rst:110 +#: ../../build/docs/basic/withPoints.rst:418 +#: ../../build/docs/basic/withPoints.rst:457 msgid "For ``walk_net``:" msgstr "Para ``walk_net``:" -#: ../../build/docs/basic/plpgsql_function.rst:112 +#: ../../build/docs/basic/withPoints.rst:112 msgid "Modify the above queries to create the ``walk_net_vertices`` table." msgstr "" "Modificar las consultas anteriores para crear la tabla " "``walk_net_vertices``." -#: ../../build/docs/basic/plpgsql_function.rst:120 +#: ../../build/docs/basic/withPoints.rst:120 msgid "It is left to the reader to remove disconected components on the views." msgstr "" "Se deja al lector la tarea de eliminar los componentes desconectados en " "las vistas." -#: ../../build/docs/basic/plpgsql_function.rst:122 +#: ../../build/docs/basic/withPoints.rst:122 msgid "See :doc:`graphs`" msgstr "Ver :doc:`graphs`" -#: ../../build/docs/basic/plpgsql_function.rst:125 +#: ../../build/docs/basic/withPoints.rst:125 msgid "Exercise 3: Nearest Vertex" msgstr "Ejercicio 3: Vértice más cercano" -#: ../../build/docs/basic/plpgsql_function.rst:129 +#: ../../build/docs/basic/withPoints.rst:129 msgid "Calculate the (OSM) identifier of the nearest vertex to a point." msgstr "Calculer el identificador( OSM) del vértice más cercano a un punto." -#: ../../build/docs/basic/plpgsql_function.rst:131 +#: ../../build/docs/basic/withPoints.rst:131 msgid "" "In particular use the following (lat, lon) value: ``(-1.455829, " "-48.446044)``." @@ -363,32 +363,32 @@ msgstr "" "En particular, utilizar el siguiente valor (lat,lon): ``(-1.455829, " "-48.446044)``." -#: ../../build/docs/basic/plpgsql_function.rst:133 -#: ../../build/docs/basic/plpgsql_function.rst:265 +#: ../../build/docs/basic/withPoints.rst:133 +#: ../../build/docs/basic/withPoints.rst:265 msgid "calculate the nearest OSM identifier of the vertex to:" msgstr "calcular el identificador OSM más cercano del vértice a:" -#: ../../build/docs/basic/plpgsql_function.rst:135 -#: ../../build/docs/basic/plpgsql_function.rst:267 +#: ../../build/docs/basic/withPoints.rst:135 +#: ../../build/docs/basic/withPoints.rst:267 msgid "``ways_vertices``" msgstr "``ways_vertices``" -#: ../../build/docs/basic/plpgsql_function.rst:136 -#: ../../build/docs/basic/plpgsql_function.rst:268 +#: ../../build/docs/basic/withPoints.rst:136 +#: ../../build/docs/basic/withPoints.rst:268 msgid "``vehicle_net_vertices``" msgstr "``vehicle_net_vertices``" -#: ../../build/docs/basic/plpgsql_function.rst:137 -#: ../../build/docs/basic/plpgsql_function.rst:269 +#: ../../build/docs/basic/withPoints.rst:137 +#: ../../build/docs/basic/withPoints.rst:269 msgid "``taxi_net_vertices``" msgstr "``taxi_net_vertices``" -#: ../../build/docs/basic/plpgsql_function.rst:138 -#: ../../build/docs/basic/plpgsql_function.rst:270 +#: ../../build/docs/basic/withPoints.rst:138 +#: ../../build/docs/basic/withPoints.rst:270 msgid "``walk_net_vertices``" msgstr "``walk_net_vertices``" -#: ../../build/docs/basic/plpgsql_function.rst:142 +#: ../../build/docs/basic/withPoints.rst:142 msgid "" "Remember that the ``id`` has an OSM vertex identifier on the vertices " "tables." @@ -396,7 +396,7 @@ msgstr "" "Recordar que el ``id`` tiene un identificador de vértice OSM en las " "tablas de vértices." -#: ../../build/docs/basic/plpgsql_function.rst:143 +#: ../../build/docs/basic/withPoints.rst:143 msgid "" "Using the Postgis distance operator `<-> " "`__ to order by " @@ -406,44 +406,44 @@ msgstr "" "`__ para ordenar por" " distancia." -#: ../../build/docs/basic/plpgsql_function.rst:144 +#: ../../build/docs/basic/withPoints.rst:144 msgid "Get only the first row, to obtain the nearest identifier of the vertex." msgstr "" "Obtenga solo la primera fila para obtener el identificador más cercano " "del vértice." -#: ../../build/docs/basic/plpgsql_function.rst:146 -#: ../../build/docs/basic/plpgsql_function.rst:274 +#: ../../build/docs/basic/withPoints.rst:146 +#: ../../build/docs/basic/withPoints.rst:274 msgid "For ``ways_vertices``:" msgstr "Para ``ways_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:157 +#: ../../build/docs/basic/withPoints.rst:157 msgid "For ``vehicle_net_vertices``:" msgstr "Para``vehicle_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:159 -#: ../../build/docs/basic/plpgsql_function.rst:174 -#: ../../build/docs/basic/plpgsql_function.rst:182 -#: ../../build/docs/basic/plpgsql_function.rst:293 -#: ../../build/docs/basic/plpgsql_function.rst:306 +#: ../../build/docs/basic/withPoints.rst:159 +#: ../../build/docs/basic/withPoints.rst:174 +#: ../../build/docs/basic/withPoints.rst:182 +#: ../../build/docs/basic/withPoints.rst:293 +#: ../../build/docs/basic/withPoints.rst:306 msgid "Modify the previous query." msgstr "Modificar la consulta anterior." -#: ../../build/docs/basic/plpgsql_function.rst:172 -#: ../../build/docs/basic/plpgsql_function.rst:304 +#: ../../build/docs/basic/withPoints.rst:172 +#: ../../build/docs/basic/withPoints.rst:304 msgid "For ``taxi_net_vertices``:" msgstr "Para ``taxi_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:180 -#: ../../build/docs/basic/plpgsql_function.rst:312 +#: ../../build/docs/basic/withPoints.rst:180 +#: ../../build/docs/basic/withPoints.rst:312 msgid "For ``walk_net_vertices``:" msgstr "Para ``walk_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:190 +#: ../../build/docs/basic/withPoints.rst:190 msgid "Exercise 4: Nearest vertex function" msgstr "Ejercicio 4: Función de vértice más cercano" -#: ../../build/docs/basic/plpgsql_function.rst:194 +#: ../../build/docs/basic/withPoints.rst:194 msgid "" "When operations look similar for different tables, a function can be " "created." @@ -451,7 +451,7 @@ msgstr "" "Cuando las operaciones se ven similares para diferentes tablas, se puede " "crear una función." -#: ../../build/docs/basic/plpgsql_function.rst:196 +#: ../../build/docs/basic/withPoints.rst:196 msgid "" "Create a function that calculates the OSM identifier of the nearest " "vertex to a point." @@ -459,59 +459,59 @@ msgstr "" "Cree una función que calcule el identificador OSM del vértice más cercano" " a un punto." -#: ../../build/docs/basic/plpgsql_function.rst:197 +#: ../../build/docs/basic/withPoints.rst:197 msgid "Function name: ``wrk_nearest``." msgstr "Nombre de la función: ``wrk_Nearest``." -#: ../../build/docs/basic/plpgsql_function.rst:198 +#: ../../build/docs/basic/withPoints.rst:198 msgid "Needs to work only for the **final application** views and table." msgstr "Solo tiene que funcionar para las vistas y la tabla **aplicación final**." -#: ../../build/docs/basic/plpgsql_function.rst:201 +#: ../../build/docs/basic/withPoints.rst:201 msgid "The input parameters:" msgstr "Los parámetros de entrada:" -#: ../../build/docs/basic/plpgsql_function.rst:206 +#: ../../build/docs/basic/withPoints.rst:206 msgid "vertex_table" msgstr "vertex_table" -#: ../../build/docs/basic/plpgsql_function.rst:206 +#: ../../build/docs/basic/withPoints.rst:206 msgid "Table name identifier." msgstr "Identificador de nombre de tabla." -#: ../../build/docs/basic/plpgsql_function.rst:207 +#: ../../build/docs/basic/withPoints.rst:207 msgid "lat" msgstr "lat" -#: ../../build/docs/basic/plpgsql_function.rst:207 +#: ../../build/docs/basic/withPoints.rst:207 msgid "The latitude of a point." msgstr "La latitud de un punto." -#: ../../build/docs/basic/plpgsql_function.rst:208 +#: ../../build/docs/basic/withPoints.rst:208 msgid "lon" msgstr "lon" -#: ../../build/docs/basic/plpgsql_function.rst:208 +#: ../../build/docs/basic/withPoints.rst:208 msgid "The longitude of a point." msgstr "La longitud de un punto." -#: ../../build/docs/basic/plpgsql_function.rst:211 +#: ../../build/docs/basic/withPoints.rst:211 msgid "The output:" msgstr "La salida:" -#: ../../build/docs/basic/plpgsql_function.rst:216 +#: ../../build/docs/basic/withPoints.rst:216 msgid "BIGINT" msgstr "BIGINT" -#: ../../build/docs/basic/plpgsql_function.rst:216 +#: ../../build/docs/basic/withPoints.rst:216 msgid "the OSM identifier that is nearest to (lat,lon)." msgstr "el identificador OSM más cercano a (lat,lon)." -#: ../../build/docs/basic/plpgsql_function.rst:221 +#: ../../build/docs/basic/withPoints.rst:221 msgid "The function returns only one ``BIGINT`` value." msgstr "La función devuelve sólo un valor ``BIGINT``." -#: ../../build/docs/basic/plpgsql_function.rst:222 +#: ../../build/docs/basic/withPoints.rst:222 msgid "" "Using `format `__ to build the query." @@ -519,7 +519,7 @@ msgstr "" "Usando `format `__ para construir la consulta." -#: ../../build/docs/basic/plpgsql_function.rst:226 +#: ../../build/docs/basic/withPoints.rst:226 msgid "" "The structure of the query is similar to `Exercise 3: Nearest Vertex`_ " "solutions." @@ -527,61 +527,61 @@ msgstr "" "La estructura de la consulta es similar a las soluciones `Ejercicio 3: " "Vértice más cercano`_." -#: ../../build/docs/basic/plpgsql_function.rst:228 +#: ../../build/docs/basic/withPoints.rst:228 msgid "``%1$I`` for the table name identifier." msgstr "``%1$I`` para el identificador de nombre de tabla." -#: ../../build/docs/basic/plpgsql_function.rst:229 +#: ../../build/docs/basic/withPoints.rst:229 msgid "``%2$s`` and ``%3$s`` for the latitude and longitude." msgstr "``%2$s`` y ``%3$s`` para la latitud y longitud." -#: ../../build/docs/basic/plpgsql_function.rst:231 +#: ../../build/docs/basic/withPoints.rst:231 msgid "The point is formed with (lon/lat) ``(%3$s, %2$s)``." msgstr "El punto se forma con (lon/lat) ``(%3$s, %2$s)``." -#: ../../build/docs/basic/plpgsql_function.rst:241 +#: ../../build/docs/basic/withPoints.rst:241 msgid "Exercise 5: Test nearest vertex function" msgstr "Ejercicio 5: Prueba de la función vértice más cercano" -#: ../../build/docs/basic/plpgsql_function.rst:243 +#: ../../build/docs/basic/withPoints.rst:243 msgid "Nearest Vertex in vehicle network" msgstr "Nodo más cercano en la red vehicular" -#: ../../build/docs/basic/plpgsql_function.rst:247 +#: ../../build/docs/basic/withPoints.rst:247 msgid "Nearest Vertex in taxi network" msgstr "Vértice más cercano en la red de taxis" -#: ../../build/docs/basic/plpgsql_function.rst:251 +#: ../../build/docs/basic/withPoints.rst:251 msgid "Nearest Vertex in walk network" msgstr "Nodo más cercano en la red peatonal" -#: ../../build/docs/basic/plpgsql_function.rst:257 +#: ../../build/docs/basic/withPoints.rst:257 msgid "Test the ``wrk_Nearest`` function." msgstr "Probar la función ``wrk_Nearest``." -#: ../../build/docs/basic/plpgsql_function.rst:259 +#: ../../build/docs/basic/withPoints.rst:259 msgid "Use the following (lat,lon) values: ``(-1.455829, -48.446044)``." msgstr "Usar los siguientes valores (lat,lon): ``(-1.455829, -48.446044)``." -#: ../../build/docs/basic/plpgsql_function.rst:261 +#: ../../build/docs/basic/withPoints.rst:261 msgid "The point is the same as in `Exercise 3: Nearest Vertex`_ problem." msgstr "El punto es el mismo que en `Ejercicio 3: Vértice más cercano`_." -#: ../../build/docs/basic/plpgsql_function.rst:263 +#: ../../build/docs/basic/withPoints.rst:263 msgid "Verify the results are the same." msgstr "Compruebe que los resultados son los mismos." -#: ../../build/docs/basic/plpgsql_function.rst:276 +#: ../../build/docs/basic/withPoints.rst:276 msgid "Use the function with ``ways_vertices`` as the ``vertex_table`` parameter." msgstr "" "Utilizar la función con ``ways_vertices`` como parámetro de " "``vertex_table``." -#: ../../build/docs/basic/plpgsql_function.rst:277 +#: ../../build/docs/basic/withPoints.rst:277 msgid "Pass the (lat,lon) values as second and third parameters." msgstr "Pasar los valores (lat,lon) como segundo y tercer parámetro." -#: ../../build/docs/basic/plpgsql_function.rst:278 +#: ../../build/docs/basic/withPoints.rst:278 msgid "" "Using the function on the original data does not return the OSM " "identifier." @@ -589,184 +589,184 @@ msgstr "" "El uso de la función en los datos originales no devuelve el identificador" " de OSM." -#: ../../build/docs/basic/plpgsql_function.rst:280 +#: ../../build/docs/basic/withPoints.rst:280 msgid "The value stored in ``id`` column is not the OSM identifier." msgstr "El valor almacenado en la columna ``id`` no es el identificador de OSM." -#: ../../build/docs/basic/plpgsql_function.rst:291 +#: ../../build/docs/basic/withPoints.rst:291 msgid "For ``vehicles_net_vertices``:" msgstr "Para ``vehicles_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:320 +#: ../../build/docs/basic/withPoints.rst:320 msgid "wrk_fromAtoB function" msgstr "función wrk_fromAtoB" -#: ../../build/docs/basic/plpgsql_function.rst:322 +#: ../../build/docs/basic/withPoints.rst:322 msgid "" "In this section, creation and testing the required function will be " "tackled." msgstr "En esta sección, se abordará la creación y prueba de la función requerida." -#: ../../build/docs/basic/plpgsql_function.rst:326 +#: ../../build/docs/basic/withPoints.rst:326 msgid "Exercise 6: Creating the main function" msgstr "Ejercicio 6: Creación de la función principal" -#: ../../build/docs/basic/plpgsql_function.rst:330 +#: ../../build/docs/basic/withPoints.rst:330 msgid "Create the function ``wrk_fromAtoB``." msgstr "Crear la función ``wrk_fromAtoB``." -#: ../../build/docs/basic/plpgsql_function.rst:331 +#: ../../build/docs/basic/withPoints.rst:331 msgid "Follow the description given at `Requirements for routing from A to B`_." msgstr "Siga la descripción dada en `Requisitos para el ruteo de A a B`_." -#: ../../build/docs/basic/plpgsql_function.rst:332 +#: ../../build/docs/basic/withPoints.rst:332 msgid "Use specialized functions:" msgstr "Utilizar funciones especializadas:" -#: ../../build/docs/basic/plpgsql_function.rst:334 +#: ../../build/docs/basic/withPoints.rst:334 msgid "``wrk_NearestOSM`` created on `Exercise 4: Nearest vertex function`_." msgstr "" "``wrk_NearestOSM`` creado en `Ejercicio 4: Función de vértice más " "cercano`_." -#: ../../build/docs/basic/plpgsql_function.rst:336 +#: ../../build/docs/basic/withPoints.rst:336 msgid "It receives the point in natural language format." msgstr "Recibe el punto en formato de lenguaje natural." -#: ../../build/docs/basic/plpgsql_function.rst:337 +#: ../../build/docs/basic/withPoints.rst:337 msgid "Obtains the OSM identifier needed by ``wrk_dijkstra``." msgstr "Obtiene el identificador OSM necesario por ``wrk_dijkstra``." -#: ../../build/docs/basic/plpgsql_function.rst:339 +#: ../../build/docs/basic/withPoints.rst:339 msgid "``wrk_dijkstra`` created in :doc:`sql_function`" msgstr "``wrk_dijkstra`` creado en :doc:`sql_function`" -#: ../../build/docs/basic/plpgsql_function.rst:343 +#: ../../build/docs/basic/withPoints.rst:343 msgid "The function's signature:" msgstr "Firma de la función:" -#: ../../build/docs/basic/plpgsql_function.rst:345 +#: ../../build/docs/basic/withPoints.rst:345 msgid "The input parameters highlighted." msgstr "Los parámetros de entrada están resaltados." -#: ../../build/docs/basic/plpgsql_function.rst:346 +#: ../../build/docs/basic/withPoints.rst:346 msgid "The output columns are not highlighted." msgstr "Las columnas de salida no están resaltadas." -#: ../../build/docs/basic/plpgsql_function.rst:347 +#: ../../build/docs/basic/withPoints.rst:347 msgid "The function returns a set of values." msgstr "La función devuelve un conjunto de valores." -#: ../../build/docs/basic/plpgsql_function.rst:357 +#: ../../build/docs/basic/withPoints.rst:357 msgid "The function's body:" msgstr "Cuerpo de la función:" -#: ../../build/docs/basic/plpgsql_function.rst:359 +#: ../../build/docs/basic/withPoints.rst:359 msgid "Call to the function ``wrk_dijkstra``" msgstr "Llamada a la función ``wrk_dijkstra``" -#: ../../build/docs/basic/plpgsql_function.rst:361 +#: ../../build/docs/basic/withPoints.rst:361 msgid "Using PostgreSQL ``format`` to make substitutions" msgstr "Usando ``format`` de PostgreSQL para realizar sustituciones" -#: ../../build/docs/basic/plpgsql_function.rst:363 +#: ../../build/docs/basic/withPoints.rst:363 msgid "The first parameter is the string to be replaced" msgstr "El primer parámetro es la cadena que debe ser sustituida" -#: ../../build/docs/basic/plpgsql_function.rst:364 +#: ../../build/docs/basic/withPoints.rst:364 msgid "The rest are the data parameters, are the strings use for replacement." msgstr "El resto son los parámetros de datos, son las cadenas para la sustitución." -#: ../../build/docs/basic/plpgsql_function.rst:366 +#: ../../build/docs/basic/withPoints.rst:366 msgid "``wrk_dijkstra`` obtains the values for the output" msgstr "``wrk_dijkstra`` obtiene los valores para la salida" -#: ../../build/docs/basic/plpgsql_function.rst:367 +#: ../../build/docs/basic/withPoints.rst:367 msgid "The ``edges_subset`` value will replace ``%1$I``:" msgstr "El valor de ``edges_subset`` sustituirá a ``%1$I``:" -#: ../../build/docs/basic/plpgsql_function.rst:368 +#: ../../build/docs/basic/withPoints.rst:368 msgid "For the ``source`` and ``target``:" msgstr "Para el ``source`` y ``target``:" -#: ../../build/docs/basic/plpgsql_function.rst:370 +#: ../../build/docs/basic/withPoints.rst:370 msgid "``wrk_Nearest`` is used to find the identifier." msgstr "``wrk_Nearest`` se utiliza para encontrar el identificador." -#: ../../build/docs/basic/plpgsql_function.rst:372 +#: ../../build/docs/basic/withPoints.rst:372 msgid "The vertices table name is formed with ``%1$I_vertices``." msgstr "El nombre de la tabla de vértices se forma con ``%1$I_vertices``." -#: ../../build/docs/basic/plpgsql_function.rst:374 +#: ../../build/docs/basic/withPoints.rst:374 msgid "``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively." msgstr "" "Los valores ``lat1``, ``lon1`` sustituirán a ``%2$s, %3$s`` " "respectivamente." -#: ../../build/docs/basic/plpgsql_function.rst:375 +#: ../../build/docs/basic/withPoints.rst:375 msgid "``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively." msgstr "" "Los valores ``lat2``, ``lon2`` sustituirán a ``%4$s, %5$s`` " "respectivamente." -#: ../../build/docs/basic/plpgsql_function.rst:377 +#: ../../build/docs/basic/withPoints.rst:377 msgid "To get the constructed query in form of a warning:" msgstr "Para obtener la consulta construida en forma de advertencia:" -#: ../../build/docs/basic/plpgsql_function.rst:379 +#: ../../build/docs/basic/withPoints.rst:379 msgid "The ``WARNING`` will be issued only when ``do_debug`` is true." msgstr "El ``WARNING`` se emitirá sólo cuando ``do_debug`` sea cierto." -#: ../../build/docs/basic/plpgsql_function.rst:380 +#: ../../build/docs/basic/withPoints.rst:380 msgid "No output will be generated." msgstr "No se generará ninguna salida." -#: ../../build/docs/basic/plpgsql_function.rst:398 +#: ../../build/docs/basic/withPoints.rst:398 msgid "Exercise 7: Using the main function" msgstr "Ejercicio 7: Uso de la función principal" -#: ../../build/docs/basic/plpgsql_function.rst:400 +#: ../../build/docs/basic/withPoints.rst:400 msgid "View of roads for taxis along with source and destination" msgstr "Vista de las calles para taxis junto con el origen y el destino" -#: ../../build/docs/basic/plpgsql_function.rst:406 +#: ../../build/docs/basic/withPoints.rst:406 msgid "Use ``wrk_fromAtoB``" msgstr "Usar ``wrk_fromAtoB``" -#: ../../build/docs/basic/plpgsql_function.rst:408 +#: ../../build/docs/basic/withPoints.rst:408 msgid "Departure point is: (lat,lon) = ``(-1.455829, -48.446044)``" msgstr "El punto de partida es: (lat,lon) = ``(-1.455829, -48.446044)``" -#: ../../build/docs/basic/plpgsql_function.rst:409 +#: ../../build/docs/basic/withPoints.rst:409 msgid "Destination point is: (lat,lon) = ``(-1.453448, -48.447142)``" msgstr "El punto de destino es: (lat,lon) = ``(-1.453448, -48.447142)``" -#: ../../build/docs/basic/plpgsql_function.rst:412 -#: ../../build/docs/basic/plpgsql_function.rst:420 +#: ../../build/docs/basic/withPoints.rst:412 +#: ../../build/docs/basic/withPoints.rst:420 msgid "Use with default value of ``do_debug``." msgstr "Utilizar con el valor predeterminado de ``do_debug``." -#: ../../build/docs/basic/plpgsql_function.rst:416 +#: ../../build/docs/basic/withPoints.rst:416 msgid "Use with ``do_debug`` set to ``true``." msgstr "Utilizar con ``do_debug`` establecido en ``true``." -#: ../../build/docs/basic/plpgsql_function.rst:421 +#: ../../build/docs/basic/withPoints.rst:421 msgid "Store results on a table." msgstr "Almacene los resultados en una tabla." -#: ../../build/docs/basic/plpgsql_function.rst:422 +#: ../../build/docs/basic/withPoints.rst:422 msgid "Show the table contents." msgstr "Mostrar el contenido de la tabla." -#: ../../build/docs/basic/plpgsql_function.rst:425 +#: ../../build/docs/basic/withPoints.rst:425 msgid "The function is not meant to be used with ``ways``" msgstr "La función no está destinada a ser utilizada con ``formas``" -#: ../../build/docs/basic/plpgsql_function.rst:431 +#: ../../build/docs/basic/withPoints.rst:431 msgid "The first parameter is the table name." msgstr "El primer parámetro es el nombre de la tabla." -#: ../../build/docs/basic/plpgsql_function.rst:432 +#: ../../build/docs/basic/withPoints.rst:432 msgid "" "The next two parameters are the latitude and longitude of the departure " "point." @@ -774,7 +774,7 @@ msgstr "" "Los dos siguientes dos parámetros son la latitud y longitud del punto de " "partida." -#: ../../build/docs/basic/plpgsql_function.rst:433 +#: ../../build/docs/basic/withPoints.rst:433 msgid "" "The next two parameters are the latitude and longitude of the destination" " point." @@ -782,6 +782,6 @@ msgstr "" "Los dos siguientes dos parámetros son la latitud y longitud del punto de " "destino." -#: ../../build/docs/basic/plpgsql_function.rst:446 +#: ../../build/docs/basic/withPoints.rst:446 msgid "Do a dry run by adding ``true`` to get the query that is executed." msgstr "Agregar ``true`` para obtener la consulta que es ejecutuda." diff --git a/locale/pot/basic/plpgsql_function.pot b/locale/pot/basic/plpgsql_function.pot deleted file mode 100644 index 213779d9d..000000000 --- a/locale/pot/basic/plpgsql_function.pot +++ /dev/null @@ -1,690 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2010-2025 pgRouting Developers -# This file is distributed under the same license as the Workshop FOSS4G Auckland package. -# FIRST AUTHOR , YEAR. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: Workshop FOSS4G Auckland 3.1\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-09-30 17:36+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" -"Language-Team: LANGUAGE \n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" - -#: ../../build/docs/basic/plpgsql_function.rst:11 -msgid "pl/pgsql function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:17 -msgid "Other kind of functions are `pl/pgsql `__. As the applications requirements become more complex, using wrappers of previously defined functions becomes necessary for clarity." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:22 -msgid "Chapter contents" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:25 -msgid "Requirements for routing from A to B" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:28 -msgid "Chapter problem:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:29 -msgid "Create a function ``wrk_fromAtoB`` that allows routing from 2 geometries." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:30 -msgid "The function takes latitude/longitude points as input parameters." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:31 -msgid "Returns a route that includes a geometry so that if can be displayed, for example, in QGIS." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:32 -msgid "Will also return some other attributes." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:34 -msgid "The detailed description:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:37 -msgid "Input parameters" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:39 -msgid "Parameter" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:39 -#: ../../build/docs/basic/plpgsql_function.rst:204 -#: ../../build/docs/basic/plpgsql_function.rst:214 -msgid "type" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:39 -#: ../../build/docs/basic/plpgsql_function.rst:54 -#: ../../build/docs/basic/plpgsql_function.rst:204 -#: ../../build/docs/basic/plpgsql_function.rst:214 -msgid "Description" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:41 -msgid "``edges_subset``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:41 -#: ../../build/docs/basic/plpgsql_function.rst:206 -msgid "REGCLASS" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:41 -msgid "Edge table name identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:42 -msgid "``lat1``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:42 -#: ../../build/docs/basic/plpgsql_function.rst:43 -#: ../../build/docs/basic/plpgsql_function.rst:44 -#: ../../build/docs/basic/plpgsql_function.rst:45 -#: ../../build/docs/basic/plpgsql_function.rst:207 -#: ../../build/docs/basic/plpgsql_function.rst:208 -msgid "NUMERIC" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:42 -msgid "The latitude of the `departure` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:43 -msgid "``lon1``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:43 -msgid "The longitude of the `departure` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:44 -msgid "``lat2``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:44 -msgid "The latitude of the `destination` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:45 -msgid "``lon2``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:45 -msgid "The longitude of the `destination` point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:46 -msgid "``do_debug``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:46 -msgid "BOOLEAN" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:46 -msgid "Flag to create a ``WARNING`` with the query that is been executed" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:52 -msgid "Output columns" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:54 -#: ../../build/docs/basic/plpgsql_function.rst:204 -msgid "Column" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:56 -msgid "``seq``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:56 -msgid "For ordering purposes." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:57 -msgid "``gid``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:57 -msgid "The edge identifier that can be used to JOIN the results to the ``ways`` table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:58 -msgid "``name``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:58 -msgid "The street name." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:59 -msgid "``azimuth``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:59 -msgid "Between start and end node of an edge." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:60 -msgid "``length``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:60 -msgid "In meters." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:61 -msgid "``minutes``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:61 -msgid "Minutes taken to traverse the segment." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:62 -msgid "``route_geom``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:62 -msgid "The road geometry with corrected directionality." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:66 -msgid "For this chapter, the following points will be used for testing." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:68 -msgid "(lat,lon) = (-36.8471438, 174.7710042)" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:69 -msgid "(lat,lon) = (-36.8524328, 174.766749)" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:72 -msgid "The Vertices Table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:74 -msgid "Graphs have a `set of edges` and a `set of vertices` associated to it. The views need their vertices table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:78 -msgid "Exercise 1: Create vertices table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:81 -#: ../../build/docs/basic/plpgsql_function.rst:128 -#: ../../build/docs/basic/plpgsql_function.rst:193 -#: ../../build/docs/basic/plpgsql_function.rst:256 -#: ../../build/docs/basic/plpgsql_function.rst:329 -#: ../../build/docs/basic/plpgsql_function.rst:405 -msgid "Problem" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:82 -msgid "Create a vertices table for the views:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:84 -msgid "``vehicle_net``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:85 -msgid "``taxi_net``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:86 -msgid "``walk_net``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:90 -#: ../../build/docs/basic/plpgsql_function.rst:141 -#: ../../build/docs/basic/plpgsql_function.rst:220 -#: ../../build/docs/basic/plpgsql_function.rst:273 -#: ../../build/docs/basic/plpgsql_function.rst:342 -#: ../../build/docs/basic/plpgsql_function.rst:428 -msgid "Solution" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:91 -msgid "Use ``pgr_extractVertices`` (explained in :doc:`graphs`) to create the vertices table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:93 -msgid "``JOIN`` the vertices table with ``ways_vertices`` (created in :doc:`graphs`) to get the ``x``, ``y``, ``geom`` information." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:96 -#: ../../build/docs/basic/plpgsql_function.rst:410 -#: ../../build/docs/basic/plpgsql_function.rst:429 -msgid "For ``vehicle_net``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:104 -#: ../../build/docs/basic/plpgsql_function.rst:414 -#: ../../build/docs/basic/plpgsql_function.rst:444 -msgid "For ``taxi_net``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:110 -#: ../../build/docs/basic/plpgsql_function.rst:418 -#: ../../build/docs/basic/plpgsql_function.rst:457 -msgid "For ``walk_net``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:112 -msgid "Modify the above queries to create the ``walk_net_vertices`` table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:120 -msgid "It is left to the reader to remove disconected components on the views." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:122 -msgid "See :doc:`graphs`" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:125 -msgid "Exercise 3: Nearest Vertex" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:129 -msgid "Calculate the (OSM) identifier of the nearest vertex to a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:131 -msgid "In particular use the following (lat, lon) value: ``(-36.8471438, 174.7710042)``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:133 -#: ../../build/docs/basic/plpgsql_function.rst:265 -msgid "calculate the nearest OSM identifier of the vertex to:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:135 -#: ../../build/docs/basic/plpgsql_function.rst:267 -msgid "``ways_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:136 -#: ../../build/docs/basic/plpgsql_function.rst:268 -msgid "``vehicle_net_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:137 -#: ../../build/docs/basic/plpgsql_function.rst:269 -msgid "``taxi_net_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:138 -#: ../../build/docs/basic/plpgsql_function.rst:270 -msgid "``walk_net_vertices``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:142 -msgid "Remember that the ``id`` has an OSM vertex identifier on the vertices tables." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:143 -msgid "Using the Postgis distance operator `<-> `__ to order by distance." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:144 -msgid "Get only the first row, to obtain the nearest identifier of the vertex." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:146 -#: ../../build/docs/basic/plpgsql_function.rst:274 -msgid "For ``ways_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:157 -msgid "For ``vehicle_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:159 -#: ../../build/docs/basic/plpgsql_function.rst:174 -#: ../../build/docs/basic/plpgsql_function.rst:182 -#: ../../build/docs/basic/plpgsql_function.rst:293 -#: ../../build/docs/basic/plpgsql_function.rst:306 -msgid "Modify the previous query." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:172 -#: ../../build/docs/basic/plpgsql_function.rst:304 -msgid "For ``taxi_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:180 -#: ../../build/docs/basic/plpgsql_function.rst:312 -msgid "For ``walk_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:190 -msgid "Exercise 4: Nearest vertex function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:194 -msgid "When operations look similar for different tables, a function can be created." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:196 -msgid "Create a function that calculates the OSM identifier of the nearest vertex to a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:197 -msgid "Function name: ``wrk_nearest``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:198 -msgid "Needs to work only for the **final application** views and table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:201 -msgid "The input parameters:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:206 -msgid "vertex_table" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:206 -msgid "Table name identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:207 -msgid "lat" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:207 -msgid "The latitude of a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:208 -msgid "lon" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:208 -msgid "The longitude of a point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:211 -msgid "The output:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:216 -msgid "BIGINT" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:216 -msgid "the OSM identifier that is nearest to (lat,lon)." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:221 -msgid "The function returns only one ``BIGINT`` value." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:222 -msgid "Using `format `__ to build the query." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:226 -msgid "The structure of the query is similar to `Exercise 3: Nearest Vertex`_ solutions." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:228 -msgid "``%1$I`` for the table name identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:229 -msgid "``%2$s`` and ``%3$s`` for the latitude and longitude." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:231 -msgid "The point is formed with (lon/lat) ``(%3$s, %2$s)``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:241 -msgid "Exercise 5: Test nearest vertex function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:243 -msgid "Nearest Vertex in vehicle network" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:247 -msgid "Nearest Vertex in taxi network" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:251 -msgid "Nearest Vertex in walk network" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:257 -msgid "Test the ``wrk_Nearest`` function." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:259 -msgid "Use the following (lat,lon) values: ``(-36.8471438, 174.7710042)``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:261 -msgid "The point is the same as in `Exercise 3: Nearest Vertex`_ problem." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:263 -msgid "Verify the results are the same." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:276 -msgid "Use the function with ``ways_vertices`` as the ``vertex_table`` parameter." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:277 -msgid "Pass the (lat,lon) values as second and third parameters." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:278 -msgid "Using the function on the original data does not return the OSM identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:280 -msgid "The value stored in ``id`` column is not the OSM identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:291 -msgid "For ``vehicles_net_vertices``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:320 -msgid "wrk_fromAtoB function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:322 -msgid "In this section, creation and testing the required function will be tackled." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:326 -msgid "Exercise 6: Creating the main function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:330 -msgid "Create the function ``wrk_fromAtoB``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:331 -msgid "Follow the description given at `Requirements for routing from A to B`_." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:332 -msgid "Use specialized functions:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:334 -msgid "``wrk_NearestOSM`` created on `Exercise 4: Nearest vertex function`_." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:336 -msgid "It receives the point in natural language format." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:337 -msgid "Obtains the OSM identifier needed by ``wrk_dijkstra``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:339 -msgid "``wrk_dijkstra`` created in :doc:`sql_function`" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:343 -msgid "The function's signature:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:345 -msgid "The input parameters highlighted." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:346 -msgid "The output columns are not highlighted." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:347 -msgid "The function returns a set of values." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:357 -msgid "The function's body:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:359 -msgid "Call to the function ``wrk_dijkstra``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:361 -msgid "Using PostgreSQL ``format`` to make substitutions" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:363 -msgid "The first parameter is the string to be replaced" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:364 -msgid "The rest are the data parameters, are the strings use for replacement." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:366 -msgid "``wrk_dijkstra`` obtains the values for the output" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:367 -msgid "The ``edges_subset`` value will replace ``%1$I``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:368 -msgid "For the ``source`` and ``target``:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:370 -msgid "``wrk_Nearest`` is used to find the identifier." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:372 -msgid "The vertices table name is formed with ``%1$I_vertices``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:374 -msgid "``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:375 -msgid "``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:377 -msgid "To get the constructed query in form of a warning:" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:379 -msgid "The ``WARNING`` will be issued only when ``do_debug`` is true." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:380 -msgid "No output will be generated." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:398 -msgid "Exercise 7: Using the main function" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:400 -msgid "View of roads for taxis along with source and destination" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:406 -msgid "Use ``wrk_fromAtoB``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:408 -msgid "Departure point is: (lat,lon) = ``(-36.8471438, 174.7710042)``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:409 -msgid "Destination point is: (lat,lon) = ``(-36.8524328, 174.766749)``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:412 -#: ../../build/docs/basic/plpgsql_function.rst:420 -msgid "Use with default value of ``do_debug``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:416 -msgid "Use with ``do_debug`` set to ``true``." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:421 -msgid "Store results on a table." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:422 -msgid "Show the table contents." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:425 -msgid "The function is not meant to be used with ``ways``" -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:431 -msgid "The first parameter is the table name." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:432 -msgid "The next two parameters are the latitude and longitude of the departure point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:433 -msgid "The next two parameters are the latitude and longitude of the destination point." -msgstr "" - -#: ../../build/docs/basic/plpgsql_function.rst:446 -msgid "Do a dry run by adding ``true`` to get the query that is executed." -msgstr "" diff --git a/locale/pot/basic/sql_function.pot b/locale/pot/basic/sql_function.pot index 4810bf209..b65cf773c 100644 --- a/locale/pot/basic/sql_function.pot +++ b/locale/pot/basic/sql_function.pot @@ -215,7 +215,7 @@ msgid "``length``" msgstr "" #: ../../build/docs/basic/sql_function.rst:74 -msgid "The leng in meters of the segment." +msgid "The length in meters of the segment." msgstr "" #: ../../build/docs/basic/sql_function.rst:75 diff --git a/locale/pot/basic/withPoints.pot b/locale/pot/basic/withPoints.pot new file mode 100644 index 000000000..78e23e087 --- /dev/null +++ b/locale/pot/basic/withPoints.pot @@ -0,0 +1,549 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2010-2025 pgRouting Developers +# This file is distributed under the same license as the Workshop FOSS4G Auckland package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Workshop FOSS4G Auckland 3.1\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-10-07 15:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../build/docs/basic/withPoints.rst:11 +msgid "Routing using points" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:17 +msgid "Other kind of functions are `pl/pgsql `__. As the applications requirements become more complex, building queries and storing queries in a variable becomes necessary" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:22 +msgid "pgRouting functions in this chapter" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:24 +msgid "`pgr_findCloseEdges`_" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:25 +msgid "`pgr_withPoints`_" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:27 +msgid "Chapter contents" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:30 +msgid "Requirements for routing lat,lon points" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:33 +msgid "Chapter problem:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:34 +msgid "Create a function ``wrk_withPoints`` that allows routing from two point geometries and works for" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:37 +msgid "``vehicle_net``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:38 +msgid "``taxi_net``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:39 +msgid "``walk_net``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:41 +msgid "The function takes as input parameters:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:43 +msgid "The edges table name" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:44 +msgid "Latitude/longitude of two point" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:46 +msgid "Returns" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:48 +msgid "the same information as in :doc:`sql_function` chapter problem." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:49 +msgid "or the query that it builds" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:52 +msgid "The detailed description:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:55 +msgid "Input parameters" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:57 +msgid "Parameter" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:57 +msgid "type" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:57 +#: ../../build/docs/basic/withPoints.rst:72 +msgid "Description" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:59 +msgid "``edges_subset``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:59 +msgid "REGCLASS" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:59 +msgid "Edge table name identifier." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:60 +msgid "``lat1``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:60 +#: ../../build/docs/basic/withPoints.rst:61 +#: ../../build/docs/basic/withPoints.rst:62 +#: ../../build/docs/basic/withPoints.rst:63 +msgid "NUMERIC" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:60 +msgid "The latitude of the `departure` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:61 +msgid "``lon1``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:61 +msgid "The longitude of the `departure` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:62 +msgid "``lat2``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:62 +msgid "The latitude of the `destination` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:63 +msgid "``lon2``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:63 +msgid "The longitude of the `destination` point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:64 +msgid "``do_debug``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:64 +msgid "BOOLEAN" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:64 +msgid "Flag to create a ``NOTICE`` with the query that is been executed" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:70 +msgid "Output columns" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:72 +msgid "Name" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:72 +msgid "Type" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:74 +msgid "``seq``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:74 +msgid "INTEGER" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:74 +msgid "A unique number for each result row." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:75 +msgid "``id``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:75 +msgid "BIGINT" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:75 +msgid "The edge identifier." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:76 +msgid "``name``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:76 +#: ../../build/docs/basic/withPoints.rst:80 +msgid "TEXT" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:76 +msgid "The name of the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:77 +msgid "``seconds``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:77 +#: ../../build/docs/basic/withPoints.rst:78 +#: ../../build/docs/basic/withPoints.rst:79 +msgid "FLOAT" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:77 +msgid "The number of seconds it takes to traverse the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:78 +msgid "``length``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:78 +msgid "The length in meters of the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:79 +msgid "``azimuth``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:79 +msgid "The azimuth of the segment." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:80 +msgid "``route_readable``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:80 +msgid "The geometry in human readable form." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:81 +msgid "``route_geom``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:81 +msgid "geometry" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:81 +msgid "The geometry of the segment in the correct direction." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:85 +msgid "For this chapter, the following points will be used for testing." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:87 +msgid "(lat,lon) = (-36.850329, 174.763094)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:88 +msgid "(lat,lon) = (-36.853675, 174.764448)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:91 +msgid "pgr_findCloseEdges" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:93 +msgid "Finds the close edges to a point geometry." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:96 +#: ../../build/docs/basic/withPoints.rst:143 +msgid "Signature Summary" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:108 +msgid "Exercise 1: Get the nearest edge" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:115 +#: ../../build/docs/basic/withPoints.rst:165 +#: ../../build/docs/basic/withPoints.rst:193 +#: ../../build/docs/basic/withPoints.rst:295 +msgid "Problem" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:116 +msgid "Get the nearest edge on the graph of the following points." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:118 +msgid "(pid, lat, lon) = (1, -36.850329, 174.763094)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:119 +msgid "(pid, lat, lon) = (2, -36.853675, 174.764448)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:122 +#: ../../build/docs/basic/withPoints.rst:172 +#: ../../build/docs/basic/withPoints.rst:200 +#: ../../build/docs/basic/withPoints.rst:315 +msgid "Solution" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:123 +msgid "Build the geometry of the points with the appropiate SRID. (lines **4** and **10**)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:125 +msgid "Get the union of the individual queries" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:138 +msgid "pgr_withPoints" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:140 +msgid "Returns the shortest path in a graph with additional temporary vertices." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:158 +msgid "Exercise 2: Point routing" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:166 +msgid "Route from point **1** to point **2** on the ``vehicle_net`` where:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:168 +msgid "point **1**: (lat, lon) = (1, -36.850329, 174.763094)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:169 +msgid "point **2**: (lat, lon) = (2, -36.853675, 174.764448)" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:173 +msgid "The query from `Exercise 1: Get the nearest edge`_ is used as the inner query for points." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:175 +msgid "Using negative values to avoid conficts with vertices with the same value:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:177 +msgid "Routing from point **-1** to point **-2**" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:190 +msgid "Exercise 3: Creating the point routing function" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:194 +msgid "Create the function ``wrk_withPoints`` to route from locations using latitude and longitude values." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:197 +msgid "Analyze the function." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:201 +msgid "Creating a ``plpgsql`` function." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:210 +msgid "Analysis" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:211 +msgid "The function's signature:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:213 +msgid "The input parameters instead of vertex identifiers, now it has the latitude and longitude of a couple of points." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:215 +msgid "The function returns the same set of values calculated on the :doc:`sql_function`." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:224 +msgid "Getting the closest query:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:226 +msgid "The query looks like the one on `Exercise 1: Get the nearest edge`_" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:227 +#: ../../build/docs/basic/withPoints.rst:244 +#: ../../build/docs/basic/withPoints.rst:262 +msgid "Using PostgreSQL ``format`` to make substitutions." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:229 +msgid "The first parameter is the string to be replaced" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:230 +msgid "The rest are the data parameters, are the strings use for replacement." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:231 +msgid "``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:232 +msgid "``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:241 +msgid "Getting the routing results:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:243 +msgid "The query looks like the one on `Exercise 2: Point routing`" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:246 +msgid "The ``edges_subset`` value will replace ``%1$I``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:247 +msgid "The ``closest_query`` value will replace ``%2$s``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:256 +msgid "Getting the additional information:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:258 +msgid "The subquery looks like the one in the function created on :doc:`sql_function`." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:260 +msgid "A joined table can not be a variable" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:263 +msgid "To make it work on the ``walk_net``, the whole query needs to be in ``TEXT``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:265 +msgid "The ``edges_subset`` value will replace ``%1$I``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:274 +msgid "Building the complete query:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:276 +msgid "The complete query looks like the one in the function created on :doc:`sql_function`." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:278 +msgid "Concatenation of strings is used." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:288 +msgid "Exercise 4: Using wrk_withPoints" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:296 +msgid "Use ``wrk_withPoints``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:298 +msgid "Departure point is: (lat,lon) = ``(-36.850329, 174.763094)``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:299 +msgid "Destination point is: (lat,lon) = ``(-36.853675, 174.764448)``" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:300 +#: ../../build/docs/basic/withPoints.rst:316 +msgid "For ``vehicle_net``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:302 +msgid "Get the names of the streets of the route." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:304 +#: ../../build/docs/basic/withPoints.rst:332 +msgid "For ``taxi_net``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:306 +msgid "Get the query that is been generated." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:308 +#: ../../build/docs/basic/withPoints.rst:345 +msgid "For ``walk_net``:" +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:310 +#: ../../build/docs/basic/withPoints.rst:321 +msgid "Use with default value of ``do_debug``." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:311 +msgid "Store results on a table." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:312 +msgid "Show the table contents." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:318 +msgid "The first parameter is the table name." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:319 +msgid "The next two parameters are the latitude and longitude of the departure point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:320 +msgid "The next two parameters are the latitude and longitude of the destination point." +msgstr "" + +#: ../../build/docs/basic/withPoints.rst:334 +msgid "Do a dry run by adding ``true`` to get the query that is executed." +msgstr "" diff --git a/locale/sv/LC_MESSAGES/basic/sql_function.po b/locale/sv/LC_MESSAGES/basic/sql_function.po index b0e979181..2e7d29064 100644 --- a/locale/sv/LC_MESSAGES/basic/sql_function.po +++ b/locale/sv/LC_MESSAGES/basic/sql_function.po @@ -215,7 +215,7 @@ msgid "``length``" msgstr "``length``" #: ../../build/docs/basic/sql_function.rst:67 -msgid "The leng in meters of the segment." +msgid "The length in meters of the segment." msgstr "Segmentets längd i meter." #: ../../build/docs/basic/sql_function.rst:68 diff --git a/locale/sv/LC_MESSAGES/basic/plpgsql_function.po b/locale/sv/LC_MESSAGES/basic/withPoints.po similarity index 62% rename from locale/sv/LC_MESSAGES/basic/plpgsql_function.po rename to locale/sv/LC_MESSAGES/basic/withPoints.po index e55c6ef38..d1a6b664e 100644 --- a/locale/sv/LC_MESSAGES/basic/plpgsql_function.po +++ b/locale/sv/LC_MESSAGES/basic/withPoints.po @@ -11,7 +11,7 @@ msgstr "" "PO-Revision-Date: 2025-07-03 07:34+0000\n" "Last-Translator: Daniel Nylander \n" "Language-Team: Swedish \n" +"pgrouting-workshop/basic-withPoints/sv/>\n" "Language: sv\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -19,11 +19,11 @@ msgstr "" "Plural-Forms: nplurals=2; plural=n != 1;\n" "X-Generator: Weblate 5.4.3\n" -#: ../../build/docs/basic/plpgsql_function.rst:11 +#: ../../build/docs/basic/withPoints.rst:11 msgid "pl/pgsql function" msgstr "pl/pgsql-funktion" -#: ../../build/docs/basic/plpgsql_function.rst:17 +#: ../../build/docs/basic/withPoints.rst:17 msgid "Other kind of functions are `pl/pgsql `__. As the applications requirements become more complex, using wrappers of previously defined functions becomes necessary for clarity." msgstr "" "Andra typer av funktioner är `pl/pgsql `__ to order by distance." msgstr "" "Använd Postgis distansoperator `<-> `__ för att beställa efter avstånd." -#: ../../build/docs/basic/plpgsql_function.rst:144 +#: ../../build/docs/basic/withPoints.rst:144 msgid "Get only the first row, to obtain the nearest identifier of the vertex." msgstr "" "Hämta bara den första raden för att få den närmaste identifieraren för " "toppunktet." -#: ../../build/docs/basic/plpgsql_function.rst:146 -#: ../../build/docs/basic/plpgsql_function.rst:274 +#: ../../build/docs/basic/withPoints.rst:146 +#: ../../build/docs/basic/withPoints.rst:274 msgid "For ``ways_vertices``:" msgstr "För ``ways_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:157 +#: ../../build/docs/basic/withPoints.rst:157 msgid "For ``vehicle_net_vertices``:" msgstr "För ``vehicle_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:159 -#: ../../build/docs/basic/plpgsql_function.rst:174 -#: ../../build/docs/basic/plpgsql_function.rst:182 -#: ../../build/docs/basic/plpgsql_function.rst:293 -#: ../../build/docs/basic/plpgsql_function.rst:306 +#: ../../build/docs/basic/withPoints.rst:159 +#: ../../build/docs/basic/withPoints.rst:174 +#: ../../build/docs/basic/withPoints.rst:182 +#: ../../build/docs/basic/withPoints.rst:293 +#: ../../build/docs/basic/withPoints.rst:306 msgid "Modify the previous query." msgstr "Ändra den tidigare förfrågan." -#: ../../build/docs/basic/plpgsql_function.rst:172 -#: ../../build/docs/basic/plpgsql_function.rst:304 +#: ../../build/docs/basic/withPoints.rst:172 +#: ../../build/docs/basic/withPoints.rst:304 msgid "For ``taxi_net_vertices``:" msgstr "För ``taxi_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:180 -#: ../../build/docs/basic/plpgsql_function.rst:312 +#: ../../build/docs/basic/withPoints.rst:180 +#: ../../build/docs/basic/withPoints.rst:312 msgid "For ``walk_net_vertices``:" msgstr "För ``walk_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:190 +#: ../../build/docs/basic/withPoints.rst:190 msgid "Exercise 4: Nearest vertex function" msgstr "Övning 4: Funktion för närmaste toppunkt" -#: ../../build/docs/basic/plpgsql_function.rst:194 +#: ../../build/docs/basic/withPoints.rst:194 msgid "When operations look similar for different tables, a function can be created." msgstr "" "När operationer ser likadana ut för olika tabeller kan en funktion skapas." -#: ../../build/docs/basic/plpgsql_function.rst:196 +#: ../../build/docs/basic/withPoints.rst:196 msgid "Create a function that calculates the OSM identifier of the nearest vertex to a point." msgstr "" "Skapa en funktion som beräknar OSM-identifieraren för det närmaste " "toppunktet till en punkt." -#: ../../build/docs/basic/plpgsql_function.rst:197 +#: ../../build/docs/basic/withPoints.rst:197 msgid "Function name: ``wrk_nearest``." msgstr "Funktionsnamn: ``wrk_nearest``." -#: ../../build/docs/basic/plpgsql_function.rst:198 +#: ../../build/docs/basic/withPoints.rst:198 msgid "Needs to work only for the **final application** views and table." msgstr "Behöver bara fungera för **slutgiltig ansökan** vyer och tabell." -#: ../../build/docs/basic/plpgsql_function.rst:201 +#: ../../build/docs/basic/withPoints.rst:201 msgid "The input parameters:" msgstr "Inmatningsparametrarna:" -#: ../../build/docs/basic/plpgsql_function.rst:206 +#: ../../build/docs/basic/withPoints.rst:206 msgid "vertex_table" msgstr "vertex_table" -#: ../../build/docs/basic/plpgsql_function.rst:206 +#: ../../build/docs/basic/withPoints.rst:206 msgid "Table name identifier." msgstr "Identifierare för tabellnamn." -#: ../../build/docs/basic/plpgsql_function.rst:207 +#: ../../build/docs/basic/withPoints.rst:207 msgid "lat" msgstr "lat" -#: ../../build/docs/basic/plpgsql_function.rst:207 +#: ../../build/docs/basic/withPoints.rst:207 msgid "The latitude of a point." msgstr "Latitud för en punkt." -#: ../../build/docs/basic/plpgsql_function.rst:208 +#: ../../build/docs/basic/withPoints.rst:208 msgid "lon" msgstr "lon" -#: ../../build/docs/basic/plpgsql_function.rst:208 +#: ../../build/docs/basic/withPoints.rst:208 msgid "The longitude of a point." msgstr "Longituden för en punkt." -#: ../../build/docs/basic/plpgsql_function.rst:211 +#: ../../build/docs/basic/withPoints.rst:211 msgid "The output:" msgstr "Utdata:" -#: ../../build/docs/basic/plpgsql_function.rst:216 +#: ../../build/docs/basic/withPoints.rst:216 msgid "BIGINT" msgstr "BIGINT" -#: ../../build/docs/basic/plpgsql_function.rst:216 +#: ../../build/docs/basic/withPoints.rst:216 msgid "the OSM identifier that is nearest to (lat,lon)." msgstr "den OSM-identifierare som ligger närmast (lat,lon)." -#: ../../build/docs/basic/plpgsql_function.rst:221 +#: ../../build/docs/basic/withPoints.rst:221 msgid "The function returns only one ``BIGINT`` value." msgstr "Funktionen returnerar endast ett ``BIGINT``-värde." -#: ../../build/docs/basic/plpgsql_function.rst:222 +#: ../../build/docs/basic/withPoints.rst:222 msgid "Using `format `__ to build the query." msgstr "" "Använda `format `__ för att bygga upp frågan." -#: ../../build/docs/basic/plpgsql_function.rst:226 +#: ../../build/docs/basic/withPoints.rst:226 msgid "The structure of the query is similar to `Exercise 3: Nearest Vertex`_ solutions." msgstr "Frågans struktur liknar `Exercise 3: Nearest Vertex`_ lösningar." -#: ../../build/docs/basic/plpgsql_function.rst:228 +#: ../../build/docs/basic/withPoints.rst:228 msgid "``%1$I`` for the table name identifier." msgstr "``%1$I`` för identifieraren av tabellnamnet." -#: ../../build/docs/basic/plpgsql_function.rst:229 +#: ../../build/docs/basic/withPoints.rst:229 msgid "``%2$s`` and ``%3$s`` for the latitude and longitude." msgstr "``%2$s`` och ``%3$s`` för latitud och longitud." -#: ../../build/docs/basic/plpgsql_function.rst:231 +#: ../../build/docs/basic/withPoints.rst:231 msgid "The point is formed with (lon/lat) ``(%3$s, %2$s)``." msgstr "Punkten bildas med (lon/lat) ``(%3$s, %2$s)``." -#: ../../build/docs/basic/plpgsql_function.rst:241 +#: ../../build/docs/basic/withPoints.rst:241 msgid "Exercise 5: Test nearest vertex function" msgstr "Övning 5: Testa funktionen för närmaste toppunkt" -#: ../../build/docs/basic/plpgsql_function.rst:243 +#: ../../build/docs/basic/withPoints.rst:243 msgid "Nearest Vertex in vehicle network" msgstr "Närmaste vertex i fordonsnätverket" -#: ../../build/docs/basic/plpgsql_function.rst:247 +#: ../../build/docs/basic/withPoints.rst:247 msgid "Nearest Vertex in taxi network" msgstr "Närmaste toppunkt i taxinätverket" -#: ../../build/docs/basic/plpgsql_function.rst:251 +#: ../../build/docs/basic/withPoints.rst:251 msgid "Nearest Vertex in walk network" msgstr "Närmaste vertex i promenadnätverk" -#: ../../build/docs/basic/plpgsql_function.rst:257 +#: ../../build/docs/basic/withPoints.rst:257 msgid "Test the ``wrk_Nearest`` function." msgstr "Testa funktionen ``wrk_Nearest``." -#: ../../build/docs/basic/plpgsql_function.rst:259 +#: ../../build/docs/basic/withPoints.rst:259 msgid "Use the following (lat,lon) values: ``(-1.455829, -48.446044)``." msgstr "Använd följande (lat,lon)-värden: ``(-1.455829, -48.446044)``." -#: ../../build/docs/basic/plpgsql_function.rst:261 +#: ../../build/docs/basic/withPoints.rst:261 msgid "The point is the same as in `Exercise 3: Nearest Vertex`_ problem." msgstr "Poängen är densamma som i `Övning 3: Närmaste vertex`_ problem." -#: ../../build/docs/basic/plpgsql_function.rst:263 +#: ../../build/docs/basic/withPoints.rst:263 msgid "Verify the results are the same." msgstr "Kontrollera att resultatet blir detsamma." -#: ../../build/docs/basic/plpgsql_function.rst:276 +#: ../../build/docs/basic/withPoints.rst:276 msgid "Use the function with ``ways_vertices`` as the ``vertex_table`` parameter." msgstr "" "Använd funktionen med ``ways_vertices`` som parameter för ``vertex_table``." -#: ../../build/docs/basic/plpgsql_function.rst:277 +#: ../../build/docs/basic/withPoints.rst:277 msgid "Pass the (lat,lon) values as second and third parameters." msgstr "Skicka (lat,lon)-värdena som andra och tredje parameter." -#: ../../build/docs/basic/plpgsql_function.rst:278 +#: ../../build/docs/basic/withPoints.rst:278 msgid "Using the function on the original data does not return the OSM identifier." msgstr "" "Om du använder funktionen på originaldata returneras inte OSM-identifieraren." -#: ../../build/docs/basic/plpgsql_function.rst:280 +#: ../../build/docs/basic/withPoints.rst:280 msgid "The value stored in ``id`` column is not the OSM identifier." msgstr "Värdet som lagras i kolumnen ``id`` är inte OSM-identifieraren." -#: ../../build/docs/basic/plpgsql_function.rst:291 +#: ../../build/docs/basic/withPoints.rst:291 msgid "For ``vehicles_net_vertices``:" msgstr "För ``vehicles_net_vertices``:" -#: ../../build/docs/basic/plpgsql_function.rst:320 +#: ../../build/docs/basic/withPoints.rst:320 msgid "wrk_fromAtoB function" msgstr "wrk_fromAtoB funktion" -#: ../../build/docs/basic/plpgsql_function.rst:322 +#: ../../build/docs/basic/withPoints.rst:322 msgid "In this section, creation and testing the required function will be tackled." msgstr "" "I detta avsnitt behandlas skapande och testning av den funktion som krävs." -#: ../../build/docs/basic/plpgsql_function.rst:326 +#: ../../build/docs/basic/withPoints.rst:326 msgid "Exercise 6: Creating the main function" msgstr "Övning 6: Skapa huvudfunktionen" -#: ../../build/docs/basic/plpgsql_function.rst:330 +#: ../../build/docs/basic/withPoints.rst:330 msgid "Create the function ``wrk_fromAtoB``." msgstr "Skapa funktionen ``wrk_fromAtoB``." -#: ../../build/docs/basic/plpgsql_function.rst:331 +#: ../../build/docs/basic/withPoints.rst:331 msgid "Follow the description given at `Requirements for routing from A to B`_." msgstr "Följ beskrivningen i avsnittet `Krav på rutten från A till B`_." -#: ../../build/docs/basic/plpgsql_function.rst:332 +#: ../../build/docs/basic/withPoints.rst:332 msgid "Use specialized functions:" msgstr "Använd specialiserade funktioner:" -#: ../../build/docs/basic/plpgsql_function.rst:334 +#: ../../build/docs/basic/withPoints.rst:334 msgid "``wrk_NearestOSM`` created on `Exercise 4: Nearest vertex function`_." msgstr "``wrk_NearestOSM`` skapad på `Övning 4: Närmaste vertexfunktion`_." -#: ../../build/docs/basic/plpgsql_function.rst:336 +#: ../../build/docs/basic/withPoints.rst:336 msgid "It receives the point in natural language format." msgstr "Den tar emot punkten i naturligt språkformat." -#: ../../build/docs/basic/plpgsql_function.rst:337 +#: ../../build/docs/basic/withPoints.rst:337 msgid "Obtains the OSM identifier needed by ``wrk_dijkstra``." msgstr "Erhåller den OSM-identifierare som behövs av ``wrk_dijkstra``." -#: ../../build/docs/basic/plpgsql_function.rst:339 +#: ../../build/docs/basic/withPoints.rst:339 msgid "``wrk_dijkstra`` created in :doc:`sql_function`" msgstr "``wrk_dijkstra`` skapad i :doc:`sql_function`" -#: ../../build/docs/basic/plpgsql_function.rst:343 +#: ../../build/docs/basic/withPoints.rst:343 msgid "The function's signature:" msgstr "Funktionens signatur:" -#: ../../build/docs/basic/plpgsql_function.rst:345 +#: ../../build/docs/basic/withPoints.rst:345 msgid "The input parameters highlighted." msgstr "Inmatningsparametrarna markeras." -#: ../../build/docs/basic/plpgsql_function.rst:346 +#: ../../build/docs/basic/withPoints.rst:346 msgid "The output columns are not highlighted." msgstr "Utdatakolumnerna är inte markerade." -#: ../../build/docs/basic/plpgsql_function.rst:347 +#: ../../build/docs/basic/withPoints.rst:347 msgid "The function returns a set of values." msgstr "Funktionen returnerar en uppsättning värden." -#: ../../build/docs/basic/plpgsql_function.rst:357 +#: ../../build/docs/basic/withPoints.rst:357 msgid "The function's body:" msgstr "Funktionens kropp:" -#: ../../build/docs/basic/plpgsql_function.rst:359 +#: ../../build/docs/basic/withPoints.rst:359 msgid "Call to the function ``wrk_dijkstra``" msgstr "Anrop till funktionen ``wrk_dijkstra``" -#: ../../build/docs/basic/plpgsql_function.rst:361 +#: ../../build/docs/basic/withPoints.rst:361 msgid "Using PostgreSQL ``format`` to make substitutions" msgstr "Använda PostgreSQL ``format`` för att göra utbyten" -#: ../../build/docs/basic/plpgsql_function.rst:363 +#: ../../build/docs/basic/withPoints.rst:363 msgid "The first parameter is the string to be replaced" msgstr "Den första parametern är den sträng som ska ersättas" -#: ../../build/docs/basic/plpgsql_function.rst:364 +#: ../../build/docs/basic/withPoints.rst:364 msgid "The rest are the data parameters, are the strings use for replacement." msgstr "" "Resten är dataparametrarna, det är strängarna som används för ersättning." -#: ../../build/docs/basic/plpgsql_function.rst:366 +#: ../../build/docs/basic/withPoints.rst:366 msgid "``wrk_dijkstra`` obtains the values for the output" msgstr "``wrk_dijkstra`` erhåller värdena för utdata" -#: ../../build/docs/basic/plpgsql_function.rst:367 +#: ../../build/docs/basic/withPoints.rst:367 msgid "The ``edges_subset`` value will replace ``%1$I``:" msgstr "Värdet ``edges_subset`` kommer att ersätta ``%1$I``:" -#: ../../build/docs/basic/plpgsql_function.rst:368 +#: ../../build/docs/basic/withPoints.rst:368 msgid "For the ``source`` and ``target``:" msgstr "För ``source`` och ``target``:" -#: ../../build/docs/basic/plpgsql_function.rst:370 +#: ../../build/docs/basic/withPoints.rst:370 msgid "``wrk_Nearest`` is used to find the identifier." msgstr "``wrk_Nearest`` används för att hitta identifieraren." -#: ../../build/docs/basic/plpgsql_function.rst:372 +#: ../../build/docs/basic/withPoints.rst:372 msgid "The vertices table name is formed with ``%1$I_vertices``." msgstr "Tabellnamnet för vertices bildas med ``%1$I_vertices``." -#: ../../build/docs/basic/plpgsql_function.rst:374 +#: ../../build/docs/basic/withPoints.rst:374 msgid "``lat1``, ``lon1`` values will replace ``%2$s, %3$s`` respectively." msgstr "" "värdena ``lat1``, ``lon1`` kommer att ersätta ``%2$s, %3$s`` respektive." -#: ../../build/docs/basic/plpgsql_function.rst:375 +#: ../../build/docs/basic/withPoints.rst:375 msgid "``lat2``, ``lon2`` values will replace ``%4$s, %5$s`` respectively." msgstr "" "värdena ``lat2``, ``lon2`` kommer att ersätta ``%4$s, %5$s`` respektive." -#: ../../build/docs/basic/plpgsql_function.rst:377 +#: ../../build/docs/basic/withPoints.rst:377 msgid "To get the constructed query in form of a warning:" msgstr "Att få den konstruerade frågan i form av en varning:" -#: ../../build/docs/basic/plpgsql_function.rst:379 +#: ../../build/docs/basic/withPoints.rst:379 msgid "The ``WARNING`` will be issued only when ``do_debug`` is true." msgstr "``WARNING`` kommer endast att utfärdas när ``do_debug`` är sant." -#: ../../build/docs/basic/plpgsql_function.rst:380 +#: ../../build/docs/basic/withPoints.rst:380 msgid "No output will be generated." msgstr "Ingen utdata kommer att genereras." -#: ../../build/docs/basic/plpgsql_function.rst:398 +#: ../../build/docs/basic/withPoints.rst:398 msgid "Exercise 7: Using the main function" msgstr "Övning 7: Använda huvudfunktionen" -#: ../../build/docs/basic/plpgsql_function.rst:400 +#: ../../build/docs/basic/withPoints.rst:400 msgid "View of roads for taxis along with source and destination" msgstr "Visning av vägar för taxibilar tillsammans med källa och destination" -#: ../../build/docs/basic/plpgsql_function.rst:406 +#: ../../build/docs/basic/withPoints.rst:406 msgid "Use ``wrk_fromAtoB``" msgstr "Använd ``wrk_fromAtoB``" -#: ../../build/docs/basic/plpgsql_function.rst:408 +#: ../../build/docs/basic/withPoints.rst:408 msgid "Departure point is: (lat,lon) = ``(-1.455829, -48.446044)``" msgstr "Avgångspunkten är: (lat,lon) = ``(-1.455829, -48.446044)``" -#: ../../build/docs/basic/plpgsql_function.rst:409 +#: ../../build/docs/basic/withPoints.rst:409 msgid "Destination point is: (lat,lon) = ``(-1.453448, -48.447142)``" msgstr "Destinationspunkten är: (lat,lon) = ``(-1,453448, -48,447142)``" -#: ../../build/docs/basic/plpgsql_function.rst:412 -#: ../../build/docs/basic/plpgsql_function.rst:420 +#: ../../build/docs/basic/withPoints.rst:412 +#: ../../build/docs/basic/withPoints.rst:420 msgid "Use with default value of ``do_debug``." msgstr "Används med standardvärdet för ``do_debug``." -#: ../../build/docs/basic/plpgsql_function.rst:416 +#: ../../build/docs/basic/withPoints.rst:416 msgid "Use with ``do_debug`` set to ``true``." msgstr "Använd med ``do_debug`` satt till ``true``." -#: ../../build/docs/basic/plpgsql_function.rst:421 +#: ../../build/docs/basic/withPoints.rst:421 msgid "Store results on a table." msgstr "Spara resultaten i en tabell." -#: ../../build/docs/basic/plpgsql_function.rst:422 +#: ../../build/docs/basic/withPoints.rst:422 msgid "Show the table contents." msgstr "Visa innehållsförteckningen." -#: ../../build/docs/basic/plpgsql_function.rst:425 +#: ../../build/docs/basic/withPoints.rst:425 msgid "The function is not meant to be used with ``ways``" msgstr "Funktionen är inte avsedd att användas med ``ways``" -#: ../../build/docs/basic/plpgsql_function.rst:431 +#: ../../build/docs/basic/withPoints.rst:431 msgid "The first parameter is the table name." msgstr "Den första parametern är tabellnamnet." -#: ../../build/docs/basic/plpgsql_function.rst:432 +#: ../../build/docs/basic/withPoints.rst:432 msgid "The next two parameters are the latitude and longitude of the departure point." msgstr "" "De två följande parametrarna är latitud och longitud för avgångspunkten." -#: ../../build/docs/basic/plpgsql_function.rst:433 +#: ../../build/docs/basic/withPoints.rst:433 msgid "The next two parameters are the latitude and longitude of the destination point." msgstr "" "De två följande parametrarna är latitud och longitud för destinationspunkten." -#: ../../build/docs/basic/plpgsql_function.rst:446 +#: ../../build/docs/basic/withPoints.rst:446 msgid "Do a dry run by adding ``true`` to get the query that is executed." msgstr "" "Gör en testkörning genom att lägga till ``true`` för att få den fråga som "