thinkgeo.mapsuite.routing.rtgroutingsource
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
thinkgeo.mapsuite.routing.rtgroutingsource [2015/09/18 03:06] admin |
thinkgeo.mapsuite.routing.rtgroutingsource [2017/03/16 21:59] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== ThinkGeo.MapSuite.Routing.RtgRoutingSource ====== | ====== ThinkGeo.MapSuite.Routing.RtgRoutingSource ====== | ||
| + | |||
| + | {{section>upgrade_map_suite_to_10.0}} | ||
| + | |||
| This class represents a RoutingSource based on an .rtg file. | This class represents a RoutingSource based on an .rtg file. | ||
| ===== Inheritance Hierarchy ===== | ===== Inheritance Hierarchy ===== | ||
| Line 9: | Line 12: | ||
| ** {{wiki:PublicMethod.gif|}} RtgRoutingSource() ** | ** {{wiki:PublicMethod.gif|}} RtgRoutingSource() ** | ||
| - | This is the class constructor. | + | * //This is the class constructor.// |
| == Remarks == | == Remarks == | ||
| - | None | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#RtgRoutingSource.28.29// |
| == Parameters == | == Parameters == | ||
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:PublicMethod.gif|}} RtgRoutingSource(String) ** | ** {{wiki:PublicMethod.gif|}} RtgRoutingSource(String) ** | ||
| - | This is the class constructor. | + | * //This is the class constructor.// |
| == Remarks == | == Remarks == | ||
| - | None | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#RtgRoutingSource.28String.29// |
| == Parameters == | == Parameters == | ||
| * //rtgFilePathName// | * //rtgFilePathName// | ||
| Line 29: | Line 32: | ||
| ** {{wiki:PublicMethod.gif|}} GetRouteSegmentCount() ** | ** {{wiki:PublicMethod.gif|}} GetRouteSegmentCount() ** | ||
| - | N/A | + | * //This method returns the count of the number of records in this RoutingSource.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method is the concrete wrapper for the virtual method GetRouteSegmentCountCore. It will return whatever is returned by the GetRouteSegmentCountCore method, along with any additions or subtractions made if you are in a transaction and that transaction is configured to be live. To determine what the default implementation of the virtual GetRouteSegmentCountCore method is, please see the documentation for it. The default implementation of GetRouteSegmentCountCore returns 0. We strongly recommend that you provide your own implementation for this method.// |
| == Return Value == | == Return Value == | ||
| * Type:Int32 | * Type:Int32 | ||
| - | * Description:N/A | + | * Description:This method returns the count of the number of records in this RoutingSource. |
| == Parameters == | == Parameters == | ||
| Line 41: | Line 44: | ||
| ** {{wiki:PublicMethod.gif|}} Open() ** | ** {{wiki:PublicMethod.gif|}} Open() ** | ||
| - | N/A | + | * //This method opens the RoutingSource so that it is initialized and ready to use.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method is the concrete wrapper for the abstract method OpenCore. The Open method plays an important role, as it is responsible for initializing the RoutingSource. Most methods on the RoutingSource will throw an exception if the state of the RoutingSource is not opened. When the map draws each layer, it will open the RoutingSource as one of its first steps, then after it is finished drawing with that layer it will close it. In this way we are sure to release all resources used by the RoutingSource. When implementing this method, consider opening files for file-based sources, connecting to databases in the database-based sources and so on. You will get a chance to close these in the Close method of the RoutingSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.// |
| == Return Value == | == Return Value == | ||
| Line 53: | Line 56: | ||
| ** {{wiki:PublicMethod.gif|}} Close() ** | ** {{wiki:PublicMethod.gif|}} Close() ** | ||
| - | N/A | + | * //This method closes the RoutingSource and releases any resources it was using.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method is the concrete wrapper for the abstract method CloseCore. The Close method plays an important role in the life cycle of the RoutingSource. It may be called after drawing to release any memory and other resources that were allocated since the Open method was called. If you override the Core version of this method, it is recommended that you take the following things into account: This method may be called multiple times, so we suggest you write the method so that a call to a closed RoutingSource is ignored and does not generate an error. We also suggest that in the Close you free all resources that have been opened. Remember that the object will not be destroyed, but will be re-opened possibly in the near future.// |
| == Return Value == | == Return Value == | ||
| Line 65: | Line 68: | ||
| ** {{wiki:PublicMethod.gif|}} GetRouteSegmentByFeatureId(String) ** | ** {{wiki:PublicMethod.gif|}} GetRouteSegmentByFeatureId(String) ** | ||
| - | N/A | + | * //This method returns a RouteSegment by providing its ID in the RoutingSource.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GetRouteSegmentByFeatureId.28String.29// |
| == Return Value == | == Return Value == | ||
| * Type:[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]] | * Type:[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]] | ||
| - | * Description:N/A | + | * Description:A RouteSegment based on a specific ID. |
| == Parameters == | == Parameters == | ||
| * //featureId// | * //featureId// | ||
| * Type:String | * Type:String | ||
| - | * Description:N/A | + | * Description:This parameter is the feature ID that uniquely identifies it in the RoutingSource. |
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:PublicMethod.gif|}} GetRouteSegmentsNearestTo(BaseShape,FeatureSource,GeographyUnit,Int32) ** | ** {{wiki:PublicMethod.gif|}} GetRouteSegmentsNearestTo(BaseShape,FeatureSource,GeographyUnit,Int32) ** | ||
| - | N/A | + | * //This method returns a user defined number of Route Segments that are closest to the TargetShape.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method returns a user defined number of Route Segments that are closest to the TargetShape. It is important to note that the TargetShape and the FeatureSource must use the same unit, such as feet or meters. If they do not, then the results will not be predictable or correct.// |
| == Return Value == | == Return Value == | ||
| * Type:Collection<[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]]> | * Type:Collection<[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]]> | ||
| - | * Description:N/A | + | * Description:This method returns a user defined number of Route Segments that are closest to the TargetShape. |
| == Parameters == | == Parameters == | ||
| * //targetShape// | * //targetShape// | ||
| * Type:[[ThinkGeo.MapSuite.Core.BaseShape|BaseShape]] | * Type:[[ThinkGeo.MapSuite.Core.BaseShape|BaseShape]] | ||
| - | * Description:N/A | + | * Description:This parameter is the shape you want to find Route Segments close to. |
| * //featureSource// | * //featureSource// | ||
| * Type:[[ThinkGeo.MapSuite.Core.FeatureSource|FeatureSource]] | * Type:[[ThinkGeo.MapSuite.Core.FeatureSource|FeatureSource]] | ||
| - | * Description:N/A | + | * Description:This parameter defines the FeatureSource that is used to get information of RouteSegments |
| * //unitOfFeatureSource// | * //unitOfFeatureSource// | ||
| * Type:[[ThinkGeo.MapSuite.Core.GeographyUnit|GeographyUnit]] | * Type:[[ThinkGeo.MapSuite.Core.GeographyUnit|GeographyUnit]] | ||
| - | * Description:N/A | + | * Description:This parameter is the unit of measurement that the TargetShape and the FeatureSource are in, such as feet, meters, etc. |
| * //numberOfItemsToFind// | * //numberOfItemsToFind// | ||
| * Type:Int32 | * Type:Int32 | ||
| - | * Description:N/A | + | * Description:This parameter defines how many close Route Segments to find around the TargetShape. |
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:PublicMethod.gif|}} BeginTransaction() ** | ** {{wiki:PublicMethod.gif|}} BeginTransaction() ** | ||
| - | N/A | + | * //This method starts a new transaction if the RoutingSource allows editing// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method is used to start a transaction, assuming that the RoutingSource allows editing. There are some additional prerequisites to beginning a transaction, such as ensuring that a transaction is not already in progress. You must also be sure that the RoutingSource has been opened. The Transaction System You start by calling BeginTransaction. This allocates a collection of in-memory change buffers that are used to store changes until you commit the transaction. So, for example, when you call the Add, Delete or Update method, the changes to the RouteSegment are stored in memory only. If for any reason you choose to abandon the transaction, you can call RollbackTransaction at any time and the in-memory buffer will be deleted and the changes will be lost. When you are ready to commit the transaction, you call CommitTransaction and the collections of changes are then passed to the CommitTransactionCore method and the implementer of the specific RoutingSource is responsible for integrating your changes into the underlying RoutingSource.// |
| == Return Value == | == Return Value == | ||
| Line 121: | Line 124: | ||
| ** {{wiki:PublicMethod.gif|}} CommitTransaction() ** | ** {{wiki:PublicMethod.gif|}} CommitTransaction() ** | ||
| - | N/A | + | * //This method will commit the existing transaction to its underlying source of data.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method is the concrete wrapper for the virtual method CommitTransactionCore. As this is the concrete version, the real work is done in the Core version of the method. It will commit the existing transaction to its underlying source of data. It will then pass back the results of the commit, including any error(s) received. Lastly, it will free up the internal memory cache of any RoutSegments added, updated or deleted. You will need to ensure that you have started a transaction by calling BeginTransaction.// |
| == Return Value == | == Return Value == | ||
| * Type:[[ThinkGeo.MapSuite.Core.TransactionResult|TransactionResult]] | * Type:[[ThinkGeo.MapSuite.Core.TransactionResult|TransactionResult]] | ||
| - | * Description:N/A | + | * Description:The returned decimalDegreesValue of this method is a TransactionResult class, which gives you the status of the transaction you just committed. It includes how many of the updates, adds, and deletes were successful and any errors that were encountered during the committing of the transaction. |
| == Parameters == | == Parameters == | ||
| Line 133: | Line 136: | ||
| ** {{wiki:PublicMethod.gif|}} RollbackTransaction() ** | ** {{wiki:PublicMethod.gif|}} RollbackTransaction() ** | ||
| - | N/A | + | * //This method will cancel an existing transaction. It will free up the internal memory cache of any InternalFeatures added, updated or deleted.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method will cancel an existing transaction. It will free up the internal memory cache of any RoutingSegments added, updated or deleted. You will need to ensure that you have started a transaction by calling BeginTransaction. The Transaction System You start by calling BeginTransaction. This allocates a collection of in-memory change buffers that are used to store changes until you commit the transaction. So, for example, when you call the Add, Delete or Update method, the changes to the RouteSegment are stored in memory only. If for any reason you choose to abandon the transaction, you can call RollbackTransaction at any time and the in-memory buffer will be deleted and the changes will be lost. When you are ready to commit the transaction, you call CommitTransaction and the collections of changes are then passed to the CommitTransactionCore method and the implementer of the specific RoutingSource is responsible for integrating your changes into the underlying RoutingSource.// |
| == Return Value == | == Return Value == | ||
| Line 145: | Line 148: | ||
| ** {{wiki:PublicMethod.gif|}} AddRouteSegment(RouteSegment) ** | ** {{wiki:PublicMethod.gif|}} AddRouteSegment(RouteSegment) ** | ||
| - | N/A | + | * //This method adds a new RouteSegment to an existing transaction.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method adds a new RouteSegment to an existing transaction. You will need to ensure that you have started a transaction by calling BeginTransaction. The Transaction System You start by calling BeginTransaction. This allocates a collection of in-memory change buffers that are used to store changes until you commit the transaction. So, for example, when you call the Add, Delete or Update method, the changes to the RouteSegment are stored in memory only. If for any reason you choose to abandon the transaction, you can call RollbackTransaction at any time and the in-memory buffer will be deleted and the changes will be lost. When you are ready to commit the transaction, you call CommitTransaction and the collections of changes are then passed to the CommitTransactionCore method and the implementer of the specific RoutingSource is responsible for integrating your changes into the underlying RoutingSource.// |
| == Return Value == | == Return Value == | ||
| Line 156: | Line 159: | ||
| * //routeSegment// | * //routeSegment// | ||
| * Type:[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]] | * Type:[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]] | ||
| - | * Description:N/A | + | * Description:This parameter represents the routeSegment that will be added to the transaction. |
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:PublicMethod.gif|}} UpdateRouteSegment(RouteSegment) ** | ** {{wiki:PublicMethod.gif|}} UpdateRouteSegment(RouteSegment) ** | ||
| - | N/A | + | * //This method deletes a RouteSegment from an existing transaction.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method update a RouteSegment to an existing transaction. You will need to ensure that you have started a transaction by calling BeginTransaction. The Transaction System You start by calling BeginTransaction. This allocates a collection of in-memory change buffers that are used to store changes until you commit the transaction. So, for example, when you call the Add, Delete or Update method, the changes to the RouteSegment are stored in memory only. If for any reason you choose to abandon the transaction, you can call RollbackTransaction at any time and the in-memory buffer will be deleted and the changes will be lost. When you are ready to commit the transaction, you call CommitTransaction and the collections of changes are then passed to the CommitTransactionCore method and the implementer of the specific RoutingSource is responsible for integrating your changes into the underlying RoutingSource.// |
| == Return Value == | == Return Value == | ||
| Line 172: | Line 175: | ||
| * //routeSegment// | * //routeSegment// | ||
| * Type:[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]] | * Type:[[ThinkGeo.MapSuite.Routing.RouteSegment|RouteSegment]] | ||
| - | * Description:N/A | + | * Description:The RouteSegment that will be updated to an existing transaction |
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:PublicMethod.gif|}} DeleteRouteSegment(String) ** | ** {{wiki:PublicMethod.gif|}} DeleteRouteSegment(String) ** | ||
| - | N/A | + | * //This method deletes a RouteSegment from an existing transaction.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //This method delete a RouteSegment from an existing transaction. You will need to ensure that you have started a transaction by calling BeginTransaction. The Transaction System You start by calling BeginTransaction. This allocates a collection of in-memory change buffers that are used to store changes until you commit the transaction. So, for example, when you call the Add, Delete or Update method, the changes to the RouteSegment are stored in memory only. If for any reason you choose to abandon the transaction, you can call RollbackTransaction at any time and the in-memory buffer will be deleted and the changes will be lost. When you are ready to commit the transaction, you call CommitTransaction and the collections of changes are then passed to the CommitTransactionCore method and the implementer of the specific RoutingSource is responsible for integrating your changes into the underlying RoutingSource.// |
| == Return Value == | == Return Value == | ||
| Line 188: | Line 191: | ||
| * //id// | * //id// | ||
| * Type:String | * Type:String | ||
| - | * Description:N/A | + | * Description:This string is the fature Id of the RouteSegment in the RoutingSource you wish to delete. |
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:PublicMethod.gif|}} ToString() ** | ** {{wiki:PublicMethod.gif|}} ToString() ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#ToString.28.29// |
| == Return Value == | == Return Value == | ||
| Line 205: | Line 208: | ||
| ** {{wiki:PublicMethod.gif|}} Equals(Object) ** | ** {{wiki:PublicMethod.gif|}} Equals(Object) ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#Equals.28Object.29// |
| == Return Value == | == Return Value == | ||
| Line 221: | Line 224: | ||
| ** {{wiki:PublicMethod.gif|}} GetHashCode() ** | ** {{wiki:PublicMethod.gif|}} GetHashCode() ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GetHashCode.28.29// |
| == Return Value == | == Return Value == | ||
| Line 233: | Line 236: | ||
| ** {{wiki:PublicMethod.gif|}} GetType() ** | ** {{wiki:PublicMethod.gif|}} GetType() ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GetType.28.29// |
| == Return Value == | == Return Value == | ||
| Line 245: | Line 248: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource) ** | ||
| - | This method generates routing data to an .rtg file based on a feature source. | + | * //This method generates routing data to an .rtg file based on a feature source.// |
| == Remarks == | == Remarks == | ||
| - | This method is the overloads method. It will use do-not-rebuild mode and an empy string as adjunctiveInformation to call other methods. | + | * //This method is the overloads method. It will use do-not-rebuild mode and an empy string as adjunctiveInformation to call other methods.// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 265: | Line 268: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource,BuildRoutingDataMode) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource,BuildRoutingDataMode) ** | ||
| - | This method generates routing data to an .rtg file based on a feature source. | + | * //This method generates routing data to an .rtg file based on a feature source.// |
| == Remarks == | == Remarks == | ||
| - | This method is the overloads method. It will use an empy string as adjunctiveInformation to call other methods. | + | * //This method is the overloads method. It will use an empy string as adjunctiveInformation to call other methods.// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 289: | Line 292: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource,BuildRoutingDataMode,String) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource,BuildRoutingDataMode,String) ** | ||
| - | This method generates routing data to an .rtg file based on a feature source. | + | * //This method generates routing data to an .rtg file based on a feature source.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GenerateRoutingData.28String.2C_FeatureSource.2C_BuildRoutingDataMode.2C_String.29// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 317: | Line 320: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource,BuildRoutingDataMode,GeographyUnit,DistanceUnit) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,FeatureSource,BuildRoutingDataMode,GeographyUnit,DistanceUnit) ** | ||
| - | This method generates routing data to an .rtg file based on a feature source. | + | * //This method generates routing data to an .rtg file based on a feature source.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GenerateRoutingData.28String.2C_FeatureSource.2C_BuildRoutingDataMode.2C_GeographyUnit.2C_DistanceUnit.29// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 349: | Line 352: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,String,BuildRoutingDataMode) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,String,BuildRoutingDataMode) ** | ||
| - | This method generates routing data to an .rtg file based on a feature source. | + | * //This method generates routing data to an .rtg file based on a feature source.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GenerateRoutingData.28String.2C_String.2C_BuildRoutingDataMode.29// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 373: | Line 376: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,String,String,BuildRoutingDataMode) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,String,String,BuildRoutingDataMode) ** | ||
| - | This method generates routing data to an .rtg file based on a feature source. | + | * //This method generates routing data to an .rtg file based on a feature source.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GenerateRoutingData.28String.2C_String.2C_String.2C_BuildRoutingDataMode.29// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 401: | Line 404: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,String,String,BuildRoutingDataMode,GeographyUnit,DistanceUnit) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutingData(String,String,String,BuildRoutingDataMode,GeographyUnit,DistanceUnit) ** | ||
| - | This method generates routing data to an .rtg file based on a feature source. | + | * //This method generates routing data to an .rtg file based on a feature source.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GenerateRoutingData.28String.2C_String.2C_String.2C_BuildRoutingDataMode.2C_GeographyUnit.2C_DistanceUnit.29// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 437: | Line 440: | ||
| ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutableShapeFile(String,String,OverwriteMode) ** | ** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GenerateRoutableShapeFile(String,String,OverwriteMode) ** | ||
| - | Create the routable shapefile which can be used to create RTG file directly. | + | * //Create the routable shapefile which can be used to create RTG file directly.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GenerateRoutableShapeFile.28String.2C_String.2C_OverwriteMode.29// |
| == Return Value == | == Return Value == | ||
| Line 462: | Line 465: | ||
| ** {{wiki:ProtectedMethod.gif|}} GetRouteSegmentByFeatureIdCore(String) ** | ** {{wiki:ProtectedMethod.gif|}} GetRouteSegmentByFeatureIdCore(String) ** | ||
| - | This method returns a RouteSegment by providing its ID in the RoutingSource. | + | * //This method returns a RouteSegment by providing its ID in the RoutingSource.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GetRouteSegmentByFeatureIdCore.28String.29// |
| == Return Value == | == Return Value == | ||
| Line 478: | Line 481: | ||
| ** {{wiki:ProtectedMethod.gif|}} OpenCore() ** | ** {{wiki:ProtectedMethod.gif|}} OpenCore() ** | ||
| - | This method opens the RoutingSource so that it is initialized and ready to use. | + | * //This method opens the RoutingSource so that it is initialized and ready to use.// |
| == Remarks == | == Remarks == | ||
| - | This protected method is called from the concrete public method Open. The Open method plays an important role, as it is responsible for initializing the RoutingSource. Most methods on the RoutingSource will throw an exception if the state of the RoutingSource is not opened. When the map draws each layer, it will open the RoutingSource as one of its first steps, then after it is finished drawing with that layer it will close it. In this way we are sure to release all resources used by the RoutingSource. This implementation of OpenCore opens the .rtg file and .rtx file. | + | * //This protected method is called from the concrete public method Open. The Open method plays an important role, as it is responsible for initializing the RoutingSource. Most methods on the RoutingSource will throw an exception if the state of the RoutingSource is not opened. When the map draws each layer, it will open the RoutingSource as one of its first steps, then after it is finished drawing with that layer it will close it. In this way we are sure to release all resources used by the RoutingSource. This implementation of OpenCore opens the .rtg file and .rtx file.// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 490: | Line 493: | ||
| ** {{wiki:ProtectedMethod.gif|}} OnStreamLoading(StreamLoadingEventArgs) ** | ** {{wiki:ProtectedMethod.gif|}} OnStreamLoading(StreamLoadingEventArgs) ** | ||
| - | This method allows you to raise the StreamLoading event. | + | * //This method allows you to raise the StreamLoading event.// |
| == Remarks == | == Remarks == | ||
| - | This method allows you to raise the StreamLoading event. Normally events are not accessible to derived classes, so we exposed a way to raise the event as necessary through this protected method. | + | * //This method allows you to raise the StreamLoading event. Normally events are not accessible to derived classes, so we exposed a way to raise the event as necessary through this protected method.// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 506: | Line 509: | ||
| ** {{wiki:ProtectedMethod.gif|}} CloseCore() ** | ** {{wiki:ProtectedMethod.gif|}} CloseCore() ** | ||
| - | This method closes the RoutingSource and releases any resources it was using. | + | * //This method closes the RoutingSource and releases any resources it was using.// |
| == Remarks == | == Remarks == | ||
| - | This method is the concrete wrapper for the abstract method CloseCore. The Close method plays an important role in the life cycle of the RoutingSource. It may be called after drawing to release any memory and other resources that were allocated since the Open method was called. If you override the Core version of this method, it is recommended that you take the following things into account: This method may be called multiple times, so we suggest you write the method so that that a call to a closed RoutingSource is ignored and does not generate an error. We also suggest that in the Close you free all resources that have been opened. Remember that the object will not be destroyed, but will be re-opened possibly in the near future. This implementation of CloseCore closes the .rtg file and .rtx file. | + | * //This method is the concrete wrapper for the abstract method CloseCore. The Close method plays an important role in the life cycle of the RoutingSource. It may be called after drawing to release any memory and other resources that were allocated since the Open method was called. If you override the Core version of this method, it is recommended that you take the following things into account: This method may be called multiple times, so we suggest you write the method so that that a call to a closed RoutingSource is ignored and does not generate an error. We also suggest that in the Close you free all resources that have been opened. Remember that the object will not be destroyed, but will be re-opened possibly in the near future. This implementation of CloseCore closes the .rtg file and .rtx file.// |
| == Return Value == | == Return Value == | ||
| * Type:Void | * Type:Void | ||
| - | * Description:None | + | * Description:N/A |
| == Parameters == | == Parameters == | ||
| Line 518: | Line 521: | ||
| ** {{wiki:ProtectedMethod.gif|}} BeginTransactionCore() ** | ** {{wiki:ProtectedMethod.gif|}} BeginTransactionCore() ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#BeginTransactionCore.28.29// |
| == Return Value == | == Return Value == | ||
| Line 530: | Line 533: | ||
| ** {{wiki:ProtectedMethod.gif|}} CommitTransactionCore(RoutingTransactionBuffer) ** | ** {{wiki:ProtectedMethod.gif|}} CommitTransactionCore(RoutingTransactionBuffer) ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#CommitTransactionCore.28RoutingTransactionBuffer.29// |
| == Return Value == | == Return Value == | ||
| Line 546: | Line 549: | ||
| ** {{wiki:ProtectedMethod.gif|}} RollbackTransactionCore() ** | ** {{wiki:ProtectedMethod.gif|}} RollbackTransactionCore() ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#RollbackTransactionCore.28.29// |
| == Return Value == | == Return Value == | ||
| Line 558: | Line 561: | ||
| ** {{wiki:ProtectedMethod.gif|}} GetRouteSegmentCountCore() ** | ** {{wiki:ProtectedMethod.gif|}} GetRouteSegmentCountCore() ** | ||
| - | This method returns the count of the number of records in this RoutingSource. | + | * //This method returns the count of the number of records in this RoutingSource.// |
| == Remarks == | == Remarks == | ||
| - | This protected method is called from the concrete public method GetCount. It does not take into account any transaction activity, as this is the responsibility of the concrete public method GetRouteSegmentCount. This way, as a developer, if you choose to override this method you do not have to consider transactions at all. The implementation of GetRouteSegmentCountCore returns the count from the .rtg file. | + | * //This protected method is called from the concrete public method GetCount. It does not take into account any transaction activity, as this is the responsibility of the concrete public method GetRouteSegmentCount. This way, as a developer, if you choose to override this method you do not have to consider transactions at all. The implementation of GetRouteSegmentCountCore returns the count from the .rtg file.// |
| == Return Value == | == Return Value == | ||
| Line 570: | Line 573: | ||
| ** {{wiki:ProtectedMethod.gif|}} GetRouteSegmentsNearestToCore(BaseShape,FeatureSource,GeographyUnit,Int32) ** | ** {{wiki:ProtectedMethod.gif|}} GetRouteSegmentsNearestToCore(BaseShape,FeatureSource,GeographyUnit,Int32) ** | ||
| - | This method returns a user defined number of Route Segments that are closest to the TargetShape. | + | * //This method returns a user defined number of Route Segments that are closest to the TargetShape.// |
| == Remarks == | == Remarks == | ||
| - | This method returns a user defined number of Route Segments that are closest to the TargetShape, and it is called in the GetRouteSegmentsNearestTo method, you need to implement it if you define a custome RoutingSource.It is important to note that the TargetShape and the FeatureSource must use the same unit, such as feet or meters. If they do not, then the results will not be predictable or correct. | + | * //This method returns a user defined number of Route Segments that are closest to the TargetShape, and it is called in the GetRouteSegmentsNearestTo method, you need to implement it if you define a custome RoutingSource.It is important to note that the TargetShape and the FeatureSource must use the same unit, such as feet or meters. If they do not, then the results will not be predictable or correct.// |
| == Return Value == | == Return Value == | ||
| Line 598: | Line 601: | ||
| ** {{wiki:ProtectedMethod.gif|}} OnCommittingTransaction(RoutingCommittingTransactionEventArgs) ** | ** {{wiki:ProtectedMethod.gif|}} OnCommittingTransaction(RoutingCommittingTransactionEventArgs) ** | ||
| - | N/A | + | * //This method allows you to raise the CommittingTransaction event from a derived class.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //You can call this method from a derived class to enable it to raise the CommittingTransaction event. This may be useful if you plan to extend the RoutingSource and you need access to the event. Details on the event: This event is raised before the CommitTransactionCore is called and allows you access to the TransactionBuffer before the transaction is committed. It also allows you to cancel the pending transaction. The TransactionBuffer is the object that stores all of the pending transactions and is accessible through this event to allow you either add, remove or modify transactions. In the event that you cancel the CommitTransaction method, the transaction remains intact and you will still be editing. This makes it a nice place to possibly check for connectivity before the TransactionCore code is run, which is where the records are actually committed. Calling the RollBackTransaction method is the only way to permanently cancel a pending transaction without committing it.// |
| == Return Value == | == Return Value == | ||
| Line 609: | Line 612: | ||
| * //e// | * //e// | ||
| * Type:[[ThinkGeo.MapSuite.Routing.RoutingCommittingTransactionEventArgs|RoutingCommittingTransactionEventArgs]] | * Type:[[ThinkGeo.MapSuite.Routing.RoutingCommittingTransactionEventArgs|RoutingCommittingTransactionEventArgs]] | ||
| - | * Description:N/A | + | * Description:This parameter is the event arguments which define the parameters passed to the recipient of the event. |
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:ProtectedMethod.gif|}} OnCommittedTransaction(RoutingCommittedTransactionEventArgs) ** | ** {{wiki:ProtectedMethod.gif|}} OnCommittedTransaction(RoutingCommittedTransactionEventArgs) ** | ||
| - | N/A | + | * //This method allows you to raise the CommittedTransaction event from a derived class.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //You can call this method from a derived class to enable it to raise the CommittedTransaction event. This may be useful if you plan to extend the RoutingSource and you need access to the event. Details on the event: This event is raised after the CommitTransactionCore is called and allows you access to the TransactionBuffer and the TransactionResults object before CommitTransaction method is returned. With this event, you can analyze the results of the transaction and do any cleanup code necessary. In the event some of the records did not commit, you can handle these items here. The TransactionResults object is passed out of the CommitTransaction method so you could analyze it then; however, this is the only place where you have access to both the TransactionResults object and the TransactionBuffer object at the same time. These are useful together to try and determine what went wrong and possibly try and re-commit them. At the time of this event, you will technically be out of the current transaction.// |
| == Return Value == | == Return Value == | ||
| Line 625: | Line 628: | ||
| * //e// | * //e// | ||
| * Type:[[ThinkGeo.MapSuite.Routing.RoutingCommittedTransactionEventArgs|RoutingCommittedTransactionEventArgs]] | * Type:[[ThinkGeo.MapSuite.Routing.RoutingCommittedTransactionEventArgs|RoutingCommittedTransactionEventArgs]] | ||
| - | * Description:N/A | + | * Description:This parameter is the event arguments which define the parameters passed to the recipient of the event. |
| <div newline></div> | <div newline></div> | ||
| ** {{wiki:ProtectedMethod.gif|}} Finalize() ** | ** {{wiki:ProtectedMethod.gif|}} Finalize() ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#Finalize.28.29// |
| == Return Value == | == Return Value == | ||
| Line 642: | Line 645: | ||
| ** {{wiki:ProtectedMethod.gif|}} MemberwiseClone() ** | ** {{wiki:ProtectedMethod.gif|}} MemberwiseClone() ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#MemberwiseClone.28.29// |
| == Return Value == | == Return Value == | ||
| Line 654: | Line 657: | ||
| ** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} OnBuildingRoutingData(BuildingRoutingDataRtgRoutingSourceEventArgs) ** | ** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} OnBuildingRoutingData(BuildingRoutingDataRtgRoutingSourceEventArgs) ** | ||
| - | This method allows you to raise the BuildingRoutingData event from a derived class. | + | * //This method allows you to raise the BuildingRoutingData event from a derived class.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#OnBuildingRoutingData.28BuildingRoutingDataRtgRoutingSourceEventArgs.29// |
| == Return Value == | == Return Value == | ||
| Line 670: | Line 673: | ||
| ** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} OnGeneratingRoutableShapefile(GeneratingRoutableShapeFileRoutingSourceEventArgs) ** | ** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} OnGeneratingRoutableShapefile(GeneratingRoutableShapeFileRoutingSourceEventArgs) ** | ||
| - | This method allows you to raise the GeneratingRoutableShapeFile event from a derived class. | + | * //This method allows you to raise the GeneratingRoutableShapeFile event from a derived class.// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //For the most updated Info for this topic, please check it here:http:wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#OnGeneratingRoutableShapefile.28GeneratingRoutableShapeFileRoutingSourceEventArgs.29// |
| == Return Value == | == Return Value == | ||
| Line 686: | Line 689: | ||
| ** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} vhQ=(ShapeFileFeatureSource,String,OverwriteMode) ** | ** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} vhQ=(ShapeFileFeatureSource,String,OverwriteMode) ** | ||
| - | N/A | + | * //N/A// |
| == Remarks == | == Remarks == | ||
| - | N/A | + | * //N/A// |
| == Return Value == | == Return Value == | ||
| Line 721: | Line 724: | ||
| Gets or sets a value indicating whether re | Gets or sets a value indicating whether re | ||
| == Remarks == | == Remarks == | ||
| - | N/A | + | For the most updated Info for this topic, please check it here:http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#ReadEndPoints |
| == Return Value == | == Return Value == | ||
| * Type:Boolean | * Type:Boolean | ||
| Line 729: | Line 732: | ||
| Gets or sets a value indicating whether we should cache the index records to improve the performance. | Gets or sets a value indicating whether we should cache the index records to improve the performance. | ||
| == Remarks == | == Remarks == | ||
| - | N/A | + | For the most updated Info for this topic, please check it here:http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#CachedIndex |
| == Return Value == | == Return Value == | ||
| * Type:Boolean | * Type:Boolean | ||
| Line 737: | Line 740: | ||
| N/A | N/A | ||
| == Remarks == | == Remarks == | ||
| - | N/A | + | For the most updated Info for this topic, please check it here:http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#GenerateRoutingData.28String.2C_String.2C_String.2C_BuildRoutingDataMode.2C_GeographyUnit.2C_DistanceUnit.29 |
| == Return Value == | == Return Value == | ||
| * Type:[[ThinkGeo.MapSuite.Core.GeographyUnit|GeographyUnit]] | * Type:[[ThinkGeo.MapSuite.Core.GeographyUnit|GeographyUnit]] | ||
| Line 745: | Line 748: | ||
| N/A | N/A | ||
| == Remarks == | == Remarks == | ||
| - | N/A | + | For the most updated Info for this topic, please check it here:http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#IsOpen |
| == Return Value == | == Return Value == | ||
| * Type:Boolean | * Type:Boolean | ||
| Line 769: | Line 772: | ||
| N/A | N/A | ||
| == Remarks == | == Remarks == | ||
| - | N/A | + | For the most updated Info for this topic, please check it here:http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#Version |
| == Return Value == | == Return Value == | ||
| * Type:Int32 | * Type:Int32 | ||
| Line 775: | Line 778: | ||
| ** {{wiki:PublicProperty.gif|}} IsInTransaction ** | ** {{wiki:PublicProperty.gif|}} IsInTransaction ** | ||
| - | N/A | + | This property returns true if the RoutingSource is in a transaction and false if it is not. |
| == Remarks == | == Remarks == | ||
| - | N/A | + | To enter a transaction, you must first call the BeginTransaction method of the RoutingSource. It is possible that some RoutingSource are read-only and do not allow edits. To end a transaction, you must either call CommitTransaction or RollbackTransaction. |
| == Return Value == | == Return Value == | ||
| * Type:Boolean | * Type:Boolean | ||
| Line 801: | Line 804: | ||
| This event is called during generating the routable shapefile from raw files. | This event is called during generating the routable shapefile from raw files. | ||
| == Remarks == | == Remarks == | ||
| - | N/A | + | For the most updated Info for this topic, please check it here:http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.Routing.RtgRoutingSource#OnGeneratingRoutableShapefile.28GeneratingRoutableShapeFileRoutingSourceEventArgs.29 |
| Event Arguments:[[ThinkGeo.MapSuite.Routing.GeneratingRoutableShapeFileRoutingSourceEventArgs|GeneratingRoutableShapeFileRoutingSourceEventArgs]] | Event Arguments:[[ThinkGeo.MapSuite.Routing.GeneratingRoutableShapeFileRoutingSourceEventArgs|GeneratingRoutableShapeFileRoutingSourceEventArgs]] | ||
| Line 813: | Line 816: | ||
| ** {{wiki:PublicEvent.gif|}} CommittingTransaction ** | ** {{wiki:PublicEvent.gif|}} CommittingTransaction ** | ||
| - | N/A | + | This event is raised after the CommitTransaction method is called, but before the CommitTransactionCore is called. This allows you access to the TransactionBuffer before the transaction is committed. It also allows you to cancel the pending commit of the transaction. |
| == Remarks == | == Remarks == | ||
| - | N/A | + | This event is raised before the CommitTransactionCore is called and allows you access to the TransactionBuffer before the transaction is committed. It also allows you to cancel the pending transaction. The TransactionBuffer is the object that stores all of the pending transactions and is accessible through this event to allow you to either add, remove or modify transactions. In the event that you cancel the CommitTransaction method, the transaction remains intact and you will still be editing. This makes it a nice place to possibly check for connectivity before the TransactionCore code is run, which is where the records are actually committed. Calling the RollBackTransaction method is the only way to permanently cancel a pending transaction without committing it. |
| Event Arguments:[[ThinkGeo.MapSuite.Routing.RoutingCommittingTransactionEventArgs|RoutingCommittingTransactionEventArgs]] | Event Arguments:[[ThinkGeo.MapSuite.Routing.RoutingCommittingTransactionEventArgs|RoutingCommittingTransactionEventArgs]] | ||
| ** {{wiki:PublicEvent.gif|}} CommittedTransaction ** | ** {{wiki:PublicEvent.gif|}} CommittedTransaction ** | ||
| - | N/A | + | This event is raised after the CommitTransaction and the CommitTransactionCore are called and allows you access to the TransactionBuffer and the TransactionResults object before CommitTransaction method is returned. |
| == Remarks == | == Remarks == | ||
| - | N/A | + | This event is raised after the CommitTransactionCore is called and allows you access to the TransactionBuffer and the TransactionResults object before CommitTransaction method is returned. With this event, you can analyse the results of the transaction and do any cleanup code necessary. In the event some of the records did not commit, you can handle those items here. The TransactionResults object is passed out of the CommitTransaction method so you could analyze it then; however, this is the only place where you have access to both the TransactionResults object and the TransactionBuffer object at the same time. These are useful together to try and determine what went wrong and possibly try and re-commit them. At the time of this event you will technically be out of the current transaction. |
| Event Arguments:[[ThinkGeo.MapSuite.Routing.RoutingCommittedTransactionEventArgs|RoutingCommittedTransactionEventArgs]] | Event Arguments:[[ThinkGeo.MapSuite.Routing.RoutingCommittedTransactionEventArgs|RoutingCommittedTransactionEventArgs]] | ||
thinkgeo.mapsuite.routing.rtgroutingsource.1442545611.txt.gz · Last modified: 2015/09/18 03:06 by admin