User Tools

Site Tools


thinkgeo.mapsuite.windowsphonecore.querytools

Table of Contents

ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools

Note: The page was created before Map Suite 10. Map Suite 10.0 organized many classes into new namespaces and assemblies as well as had a few minor breaks in compatibility. The majority of previously built code should work without modification assuming the new namespaces are added. For guidance on upgrading your existing code, please check out MapSuite 10 Upgrade Guide.

<!– Class –> This is a helper class that allows you to execute various queries.

Remarks

This is a helper class that allows you to execute various queries. It wraps the query functionality of the FeatureSource and provides a simpler and more focused set of APIs.

Inheritance Hierarchy

Members Summary

Public Constructors

Name Parameters DeclaringType Summary
Public MethodQueryTools FeatureSource This is a constructor for the class.

Protected Constructors

Name Parameters DeclaringType Summary
Protected MethodQueryTools This is a constructor for the class.

Public Methods

Name Parameters DeclaringType Summary
Public MethodEquals Object Object
Public MethodExecuteNonQuery String Executes a SQL statement against a connection object.
Public MethodGetAllFeatures ReturningColumnsType This method returns all of the InternalFeatures in the FeatureSource.
Public MethodGetAllFeatures IEnumerable<String> This method returns all of the InternalFeatures in the FeatureSource.
Public MethodGetBoundingBoxById String This method returns the bounding box for the Id specified.
Public MethodGetBoundingBoxesByIds IEnumerable<String> This method returns a collection of bounding boxes based on the collection of Ids provided.
Public MethodGetColumns This method returns the collection of columns for this FeatureSource.
Public MethodGetCount This method returns the count of all of the InternalFeatures in the FeatureSource.
Public MethodGetFeatureById String, ReturningColumnsType This method returns an InternalFeature based on an Id provided.
Public MethodGetFeatureById String, IEnumerable<String> This method returns an InternalFeature based on an Id provided.
Public MethodGetFeaturesByColumnValue String, String, ReturningColumnsType Get all of the features by passing a columnName and a specified columValue.
Public MethodGetFeaturesByColumnValue String, String, IEnumerable<String> Get all of the features by passing a columnName and a specified columValue.
Public MethodGetFeaturesByColumnValue String, String Get all of the features by passing a columnName and a specified columValue.
Public MethodGetFeaturesByIds IEnumerable<String>, IEnumerable<String> This method returns a collection of InternalFeatures based on the collection of Ids provided.
Public MethodGetFeaturesByIds IEnumerable<String>, ReturningColumnsType This method returns a collection of InternalFeatures based on the collection of Ids provided.
Public MethodGetFeaturesContaining Feature, IEnumerable<String> This method returns all of the InternalFeatures based on the target Feature and the spatial query type specified.
Public MethodGetFeaturesContaining Feature, ReturningColumnsType This method returns all of the InternalFeatures based on the target Feature and the spatial query type specified.
Public MethodGetFeaturesContaining BaseShape, ReturningColumnsType This method returns all of the InternalFeatures based on the target Feature and the spatial query type specified.
Public MethodGetFeaturesContaining BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that contain the target shape.
Public MethodGetFeaturesCrossing BaseShape, ReturningColumnsType This method returns all of the InternalFeatures that cross the target shape.
Public MethodGetFeaturesCrossing Feature, ReturningColumnsType This method returns all of the InternalFeatures that cross the target Feature.
Public MethodGetFeaturesCrossing Feature, IEnumerable<String> This method returns all of the InternalFeatures that cross the target Feature.
Public MethodGetFeaturesCrossing BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that cross the target shape.
Public MethodGetFeaturesDisjointed BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that disjoint the target Feature.
Public MethodGetFeaturesDisjointed BaseShape, ReturningColumnsType This method returns all of the InternalFeatures that disjoint the target Feature.
Public MethodGetFeaturesDisjointed Feature, ReturningColumnsType This method returns all of the InternalFeatures that disjoint the target Feature.
Public MethodGetFeaturesDisjointed Feature, IEnumerable<String> This method returns all of the InternalFeatures that disjoint the target Feature.
Public MethodGetFeaturesInsideBoundingBox RectangleShape, ReturningColumnsType This method returns all of the InternalFeatures that are inside of the boundingBox.
Public MethodGetFeaturesInsideBoundingBox RectangleShape, IEnumerable<String> This method returns all of the InternalFeatures that are inside of the boundingBox.
Public MethodGetFeaturesIntersecting Feature, ReturningColumnsType This method returns all of the InternalFeatures that intersect the target Feature.
Public MethodGetFeaturesIntersecting BaseShape, ReturningColumnsType This method returns all of the InternalFeatures that intersect the target Feature.
Public MethodGetFeaturesIntersecting Feature, IEnumerable<String> This method returns all of the InternalFeatures that intersect the target Feature.
Public MethodGetFeaturesIntersecting BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that intersect the target Feature.
Public MethodGetFeaturesNearestTo BaseShape, GeographyUnit, Int32, IEnumerable<String>, Double, DistanceUnit This method returns a user defined number of InternalFeatures that are closest to the TargetShape.
Public MethodGetFeaturesNearestTo BaseShape, GeographyUnit, Int32, IEnumerable<String> This method returns a user defined number of InternalFeatures that are closest to the TargetShape.
Public MethodGetFeaturesNearestTo BaseShape, GeographyUnit, Int32, ReturningColumnsType This method returns a user defined number of InternalFeatures that are closest to the TargetShape.
Public MethodGetFeaturesNearestTo Feature, GeographyUnit, Int32, IEnumerable<String>, Double, DistanceUnit This method returns a user defined number of InternalFeatures that are closest to the TargetShape.
Public MethodGetFeaturesNearestTo Feature, GeographyUnit, Int32, ReturningColumnsType This method returns a user defined number of InternalFeatures that are closest to the TargetFeature.
Public MethodGetFeaturesNearestTo Feature, GeographyUnit, Int32, IEnumerable<String> This method returns a user defined number of InternalFeatures that are closest to the TargetFeature.
Public MethodGetFeaturesOutsideBoundingBox RectangleShape, IEnumerable<String> This method returns all of the InternalFeatures that are outside of the boundingBox.
Public MethodGetFeaturesOutsideBoundingBox RectangleShape, ReturningColumnsType This method returns all of the InternalFeatures that are outside of the boundingBox.
Public MethodGetFeaturesOverlapping BaseShape, ReturningColumnsType This method returns all of the InternalFeatures that overlap the target Feature.
Public MethodGetFeaturesOverlapping BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that overlap the target Feature.
Public MethodGetFeaturesOverlapping Feature, IEnumerable<String> This method returns all of the InternalFeatures that overlap the target Feature.
Public MethodGetFeaturesOverlapping Feature, ReturningColumnsType This method returns all of the InternalFeatures that overlap the target Feature.
Public MethodGetFeaturesTopologicalEqual Feature, ReturningColumnsType This method returns all of the InternalFeatures that topologicalEqual the target Feature.
Public MethodGetFeaturesTopologicalEqual BaseShape, ReturningColumnsType This method returns all of the InternalFeatures that topologicalEqual the target Feature.
Public MethodGetFeaturesTopologicalEqual BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that topologicalEqual the target Feature.
Public MethodGetFeaturesTopologicalEqual Feature, IEnumerable<String> This method returns all of the InternalFeatures that topologicalEqual the target Feature.
Public MethodGetFeaturesTouching BaseShape, ReturningColumnsType This method returns all of the InternalFeatures that touch the target Feature.
Public MethodGetFeaturesTouching BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that touch the target Feature.
Public MethodGetFeaturesTouching Feature, ReturningColumnsType This method returns all of the InternalFeatures that touch the target Feature.
Public MethodGetFeaturesTouching Feature, IEnumerable<String> This method returns all of the InternalFeatures that touch the target Feature.
Public MethodGetFeaturesWithin BaseShape, ReturningColumnsType This method returns all of the InternalFeatures that are within the target Feature.
Public MethodGetFeaturesWithin Feature, ReturningColumnsType This method returns all of the InternalFeatures that are within the target Feature.
Public MethodGetFeaturesWithin Feature, IEnumerable<String> This method returns all of the InternalFeatures that are within the target Feature.
Public MethodGetFeaturesWithin BaseShape, IEnumerable<String> This method returns all of the InternalFeatures that are within the target Feature.
Public MethodGetFeaturesWithinDistanceOf Feature, GeographyUnit, DistanceUnit, Double, ReturningColumnsType This method returns a collection of InternalFeatures that are within a certain distance of the TargetFeature.
Public MethodGetFeaturesWithinDistanceOf BaseShape, GeographyUnit, DistanceUnit, Double, ReturningColumnsType This method returns a collection of InternalFeatures that are within a certain distance of the TargetShape.
Public MethodGetFeaturesWithinDistanceOf Feature, GeographyUnit, DistanceUnit, Double, IEnumerable<String> This method returns a collection of InternalFeatures that are within a certain distance of the TargetFeature.
Public MethodGetFeaturesWithinDistanceOf BaseShape, GeographyUnit, DistanceUnit, Double, IEnumerable<String> This method returns a collection of InternalFeatures that are within a certain distance of the TargetShape.
Public MethodGetHashCode Object
Public MethodGetType Object
Public MethodToString Object

Protected Methods

Name Parameters DeclaringType Summary
Protected MethodFinalize Object
Protected MethodMemberwiseClone Object

Public Properties

Name Return DeclaringType Summary
Public PropertyCanExecuteSqlQuery Boolean This property specifies whether FeatureSource can excute a SQL query or not. If it is false, then it will throw an exception when the following APIs are called: ExecuteScalar, ExecuteNonQuery, ExecuteQuery

Protected Properties

Name Return DeclaringType Summary

Public Events

Name Event Arguments DeclaringType Summary

Public Constructors

QueryTools(FeatureSource)

This is a constructor for the class.

Overloads

This constructor allows you to provide a FeatureSouce that will provide the functionality for this class's methods.

Remarks

Each of the calls in this class thunk through to the FeatureSource passed in.

Parameters

Name Type Description
featureSource FeatureSource<!– ThinkGeo.MapSuite.WindowsPhoneCore.FeatureSource –> This parameter is the FeatureSource that will provide the functionality for this class's methods.

Go Back

Protected Constructors

QueryTools()

This is a constructor for the class.

Overloads

This is the default constructor, though it is typically not intended to be used.

Remarks

This is the default constructor, though it is typically not intended to be used.

Parameters

Name Type Description

Go Back

Public Methods

Equals(Object)

Return Value

Return Type Description
Boolean<!– System.Boolean –>

Parameters

Name Type Description
obj Object<!– System.Object –>

<!– System.Object –> Go Back

ExecuteNonQuery(String)

Executes a SQL statement against a connection object.

Remarks

You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database by executing UPDATE, INSERT, or DELETE statements. Although ExecuteNonQuery does not return any rows, any output parameters or return values mapped to parameters are populated with data. For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command.

Return Value

Return Type Description
Int32<!– System.Int32 –> The number of rows affected.

Parameters

Name Type Description
sqlStatement String<!– System.String –> The sqlStatement to be excuted.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetAllFeatures(ReturningColumnsType)

This method returns all of the InternalFeatures in the FeatureSource.

Remarks

This method returns all of the InternalFeatures in the FeatureSource. It will return whatever is returned by the GetAllFeaturesCore method, along with any of the additions or subtractions made if you are in a transaction and that transaction is configured to be live.

The main purpose of this method is to be the anchor of all of our default virtual implementations within this class. We as the framework developers wanted to provide you the user with as much default virtual implementation as possible. To do this, we needed a way to get access to all of the features. For example, let's say we want to create a default implementation for finding all of the InternalFeatures in a bounding box. Because this is an abstract class, we do not know the specifics of the underlying data or how its spatial indexes work. What we do know is that if we get all of the records, then we can brute-force the answer. In this way, if you inherited from this class and only implemented this one method, we can provide default implementations for virtually every other API.

While this is nice for you the developer if you decide to create your own FeatureSource, it comes with a price: namely, it is very inefficient. In the example we just discussed (about finding all of the InternalFeatures in a bounding box), we would not want to look at every record to fulfil this method. Instead, we would want to override the GetFeaturesInsideBoundingBoxCore and implement specific code that would be faster. For example, in Oracle Spatial there is a specific SQL statement to perform this operation very quickly. The same holds true with other specific FeatureSource examples.

Most default implementations in the FeatureSource call the GetFeaturesInsideBoundingBoxCore, which by default calls the GetAllFeaturesCore. It is our advice that if you create your own FeatureSource that you ALWAYS override the GetFeatureInsideBoundingBox. This will ensure that nearly every other API will operate efficiently. Please see the specific API to determine what method it uses.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of all of the InternalFeatures in the FeatureSource.

Parameters

Name Type Description
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetAllFeatures(IEnumerable<String>)

This method returns all of the InternalFeatures in the FeatureSource.

Remarks

This method returns all of the InternalFeatures in the FeatureSource. It will return whatever is returned by the GetAllFeaturesCore method, along with any of the additions or subtractions made if you are in a transaction and that transaction is configured to be live.

The main purpose of this method is to be the anchor of all of our default virtual implementations within this class. We as the framework developers wanted to provide you the user with as much default virtual implementation as possible. To do this, we needed a way to get access to all of the features. For example, let's say we want to create a default implementation for finding all of the InternalFeatures in a bounding box. Because this is an abstract class, we do not know the specifics of the underlying data or how its spatial indexes work. What we do know is that if we get all of the records, then we can brute-force the answer. In this way, if you inherited from this class and only implemented this one method, we can provide default implementations for virtually every other API.

While this is nice for you the developer if you decide to create your own FeatureSource, it comes with a price: namely, it is very inefficient. In the example we just discussed (about finding all of the InternalFeatures in a bounding box), we would not want to look at every record to fulfil this method. Instead, we would want to override the GetFeaturesInsideBoundingBoxCore and implement specific code that would be faster. For example, in Oracle Spatial there is a specific SQL statement to perform this operation very quickly. The same holds true with other specific FeatureSource examples.

Most default implementations in the FeatureSource call the GetFeaturesInsideBoundingBoxCore, which by default calls the GetAllFeaturesCore. It is our advice that if you create your own FeatureSource that you ALWAYS override the GetFeatureInsideBoundingBox. This will ensure that nearly every other API will operate efficiently. Please see the specific API to determine what method it uses.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of all of the InternalFeatures in the FeatureSource.

Parameters

Name Type Description
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetBoundingBoxById(String)

This method returns the bounding box for the Id specified.

Remarks

This method returns the bounding box for the Id specified.

Return Value

Return Type Description
RectangleShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.RectangleShape –> This method returns the bounding box for the Id specified.

Parameters

Name Type Description
id String<!– System.String –> This parameter is the unique Id of the feature for which you want to find the bounding box.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetBoundingBoxesByIds(IEnumerable<String>)

This method returns a collection of bounding boxes based on the collection of Ids provided.

Remarks

This method returns a collection of bounding boxes based on the collection of Ids provided.

Return Value

Return Type Description
Collection<RectangleShape><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.RectangleShape} –> This method returns a collection of bounding boxes based on the collection of Ids provided.

Parameters

Name Type Description
ids IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is the collection of Ids you want to find.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetColumns()

This method returns the collection of columns for this FeatureSource.

Remarks

This method returns the collection of columns for this FeatureSource.

Return Value

Return Type Description
Collection<FeatureSourceColumn><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.FeatureSourceColumn} –> This method returns the collection of columns for this FeatureSource.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetCount()

This method returns the count of all of the InternalFeatures in the FeatureSource.

Remarks

This method returns the count of all of the InternalFeatures in the FeatureSource.

Return Value

Return Type Description
Int32<!– System.Int32 –> This method returns the count of all of the InternalFeatures in the FeatureSource.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeatureById(String, ReturningColumnsType)

This method returns an InternalFeature based on an Id provided.

Remarks

This method returns an InternalFeature based on an Id provided.

Return Value

Return Type Description
Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This method returns an InternalFeature based on an Id provided.

Parameters

Name Type Description
id String<!– System.String –> This parameter is the unique Id for the feature you want to find.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter is a list of column names you want returned with the Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeatureById(String, IEnumerable<String>)

This method returns an InternalFeature based on an Id provided.

Remarks

This method returns an InternalFeature based on an Id provided.

Return Value

Return Type Description
Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This method returns an InternalFeature based on an Id provided.

Parameters

Name Type Description
id String<!– System.String –> This parameter is the unique Id for the feature you want to find.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is a list of column names you want returned with the Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesByColumnValue(String, String, ReturningColumnsType)

Get all of the features by passing a columnName and a specified columValue.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The returnning features matches the columnValue.

Parameters

Name Type Description
columnName String<!– System.String –> The specified columnName to match the columnValue.
columnValue String<!– System.String –> The specified columnValue to match those returning features.
returningColumnType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesByColumnValue(String, String, IEnumerable<String>)

Get all of the features by passing a columnName and a specified columValue.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The returnning features matches the columnValue.

Parameters

Name Type Description
columnName String<!– System.String –> The specified columnName to match the columnValue.
columnValue String<!– System.String –> The specified columnValue to match those returning features.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesByColumnValue(String, String)

Get all of the features by passing a columnName and a specified columValue.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The returnning features matches the columnValue.

Parameters

Name Type Description
columnName String<!– System.String –> The specified columnName to match the columnValue.
columnValue String<!– System.String –> The specified columnValue to match those returning features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesByIds(IEnumerable<String>, IEnumerable<String>)

This method returns a collection of InternalFeatures based on the collection of Ids provided.

Remarks

This method returns a collection of InternalFeatures based on the collection of Ids provided.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a collection of InternalFeatures based on the collection of Ids provided.

Parameters

Name Type Description
ids IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is the collection of Ids you want to find.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is a list of column names you want returned with the Features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesByIds(IEnumerable<String>, ReturningColumnsType)

This method returns a collection of InternalFeatures based on the collection of Ids provided.

Remarks

This method returns a collection of InternalFeatures based on the collection of Ids provided.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a collection of InternalFeatures based on the collection of Ids provided.

Parameters

Name Type Description
ids IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is the collection of Ids you want to find.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter is a list of column names you want returned with the Features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesContaining(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures based on the target Feature and the spatial query type specified.

Overloads

This method returns all of the features that contain the target shape.

Remarks

This method returns all of the InternalFeatures that contain the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>ReturningColumnsType:</strong>

<strong>NoColumns</strong> - This method ensures that the returning features contain no column values.

<strong>AllColumns</strong> - This method ensures that the returning features contain all column values.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesContaining(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures based on the target Feature and the spatial query type specified.

Overloads

This method returns all of the features that contain the target feature.

Remarks

This method returns all of the InternalFeatures that contain the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>ReturningColumnsType:</strong>

<strong>NoColumns</strong> - This method ensures that the returning features contain no column values.

<strong>AllColumns</strong> - This method ensures that the returning features contain all column values.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetFeature.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesContaining(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures based on the target Feature and the spatial query type specified.

Overloads

This method returns all of the features that contain the target shape.

Remarks

This method returns all of the InternalFeatures that contain the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>ReturningColumnsType:</strong>

<strong>NoColumns</strong> - This method ensures that the returning features contain no column values.

<strong>AllColumns</strong> - This method ensures that the returning features contain all column values.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesContaining(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that contain the target shape.

Overloads

This method returns all of the features that contain the target shape.

Remarks

This method returns all of the InternalFeatures that contain the specified target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that contain the TargetShape you passed in.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesCrossing(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures that cross the target shape.

Overloads

This method returns all of the features which crosses the target shape.

Remarks

This method returns all of the InternalFeatures that cross the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>ReturningColumnsType:</strong>

<strong>NoColumns</strong> - This method ensures that the returning features contain no column values.

<strong>AllColumns</strong> - This method ensures that the returning features contain all column values.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesCrossing(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures that cross the target Feature.

Overloads

This method returns all of the features that cross the target shape.

Remarks

This method returns all of the Internalfeatures that cross the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>ReturningColumnsType:</strong>

<strong>NoColumns</strong> - This method ensures that the returning features contain no column values.

<strong>AllColumns</strong> - This method ensures that the returning features contain all column values.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesCrossing(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures that cross the target Feature.

Overloads

This method returns all of the features that cross the target shape.

Remarks

This method returns all of the Internalfeatures that cross the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>ReturningColumnsType:</strong>

<strong>NoColumns</strong> - This method ensures that the returning features contain no column values.

<strong>AllColumns</strong> - This method ensures that the returning features contain all column values.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesCrossing(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that cross the target shape.

Overloads

This method returns all of the features that cross the target shape.

Remarks

This method returns all of the InternalFeatures that cross the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies. <strong>Crossing</strong> - The Geometries share some but not all interior points, and the dimension of the intersection is less than that of at least one of the Geometries.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that cross the TargetShape you passed in.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesDisjointed(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that disjoint the target Feature.

Overloads

This method returns all of the features that cross the target shape.

Remarks

This method returns all of the InternalFeatures that disjoint the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Disjoint</strong> - The Geometries have no point in common.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesDisjointed(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures that disjoint the target Feature.

Overloads

This method returns all of the features that disjoint the target shape.

Remarks

This method returns all of the InternalFeatures that disjoint the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Disjoint</strong> - The Geometries have no point in common.

<strong>ReturningColumnsType:</strong>

<strong>NoColumns</strong> - This method ensures that the returning features contain no column values.

<strong>AllColumns</strong> - This method ensures that the returning features contain all column values.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesDisjointed(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures that disjoint the target Feature.

Overloads

This method returns all of the features that disjoint the target shape.

Remarks

This method returns all of the InternalFeatures that disjoint the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Disjoint</strong> - The Geometries have no point in common.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesDisjointed(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures that disjoint the target Feature.

Overloads

This method returns all of the features that disjoint the target shape.

Remarks

This method returns all of the InternalFeatures that disjoint the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Disjoint</strong> - The Geometries have no point in common.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the columns contained in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesInsideBoundingBox(RectangleShape, ReturningColumnsType)

This method returns all of the InternalFeatures that are inside of the boundingBox.

Overloads

This method returns all of the features that are inside of the target rectangle shape.

Remarks

This method returns all of the InternalFeatures that are inside of the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that are inside of the target rectangle shape.

Parameters

Name Type Description
boundingBox RectangleShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.RectangleShape –> This parameter specifies the target boundingBox used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesInsideBoundingBox(RectangleShape, IEnumerable<String>)

This method returns all of the InternalFeatures that are inside of the boundingBox.

Overloads

This method returns all of the features that are inside of the target rectangle shape.

Remarks

This method returns all of the InternalFeatures that are inside of the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that are inside of the target rectangle shape.

Parameters

Name Type Description
boundingBox RectangleShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.RectangleShape –> This parameter specifies the target boundingBox used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesIntersecting(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures that intersect the target Feature.

Overloads

This method returns all of the features that intersect the target shape.

Remarks

This method returns all of the InternalFeatures that intersect the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Intersecting</strong> - The Geometries have at least one point in common (the inverse of Disjoint).

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesIntersecting(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures that intersect the target Feature.

Overloads

This method returns all of the features that intersect the target shape.

Remarks

This method returns all of the InternalFeatures that intersect the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Intersecting</strong> - The Geometries have at least one point in common (the inverse of Disjoint).

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesIntersecting(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures that intersect the target Feature.

Overloads

This method returns all of the features that intersect the target shape.

Remarks

This method returns all of the InternalFeatures that intersect the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Intersecting</strong> - The Geometries have at least one point in common (the inverse of Disjoint).

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesIntersecting(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that intersect the target Feature.

Overloads

This method returns all of the features that intersect the target shape.

Remarks

This method returns all of the InternalFeatures that intersect the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Intersecting</strong> - The Geometries have at least one point in common (the inverse of Disjoint).

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesNearestTo(BaseShape, GeographyUnit, Int32, IEnumerable<String>, Double, DistanceUnit)

This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Remarks

This method returns a user defined number of InternalFeatures 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided creates a small bounding box around the TargetShape and then queries the features inside of it. If we reach the number of items to find, then we measure the returned InternalFeatures to find the nearest. If we do not find enough records, we scale up the bounding box and try again. As you can see, this is not the most efficient method. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesNearestCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter is the shape you want to find InternalFeatures close to.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of measurement that the TargetShape and the FeatureSource are in, such as feet, meters, etc.
numberOfItemsToFind Int32<!– System.Int32 –> This parameter defines how many close InternalFeatures to find around the TargetShape.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter allows you to select the field names of the column data you wish to return with each Feature.
distanceLimits Double<!– System.Double –> Limit the maximize distance proximately to search closest records.
unitOfDistance DistanceUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit –> The unit of distanceLimits parameter.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesNearestTo(BaseShape, GeographyUnit, Int32, IEnumerable<String>)

This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Remarks

This method returns a user defined number of InternalFeatures 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided create a small bounding box around the TargetShape and then queries the features inside of it. If we reach the number of items to find, then we measure the returned InternalFeatures to find the nearest. If we do not find enough records, we scale up the bounding box and try again. As you can see, this is not the most efficient method. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesNearestCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter is the shape you want to find close InternalFeatures to.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the TargetShape and the FeatureSource are in, such as feet, meters, etc.
numberOfItemsToFind Int32<!– System.Int32 –> This parameter defines how many close InternalFeatures to find around the TargetShape.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesNearestTo(BaseShape, GeographyUnit, Int32, ReturningColumnsType)

This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Remarks

This method returns a user defined number of InternalFeatures 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided create a small bounding box around the TargetShape and then queries the features inside of it. If we reach the number of items to find, then we measure the returned InternalFeatures to find the nearest. If we do not find enough records, we scale up the bounding box and try again. As you can see, this is not the most efficient method. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesNearestCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter is the shape you want to find close InternalFeatures to.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the TargetShape and the FeatureSource are in, such as feet, meters, etc.
numberOfItemsToFind Int32<!– System.Int32 –> This parameter defines how many close InternalFeatures to find around the TargetShape.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesNearestTo(Feature, GeographyUnit, Int32, IEnumerable<String>, Double, DistanceUnit)

This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Remarks

This method returns a user defined number of InternalFeatures 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided creates a small bounding box around the TargetShape and then queries the features inside of it. If we reach the number of items to find, then we measure the returned InternalFeatures to find the nearest. If we do not find enough records, we scale up the bounding box and try again. As you can see, this is not the most efficient method. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesNearestCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a user defined number of InternalFeatures that are closest to the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter is feature you want to find InternalFeatures close to.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of measurement that the TargetShape and the FeatureSource are in, such as feet, meters, etc.
numberOfItemsToFind Int32<!– System.Int32 –> This parameter defines how many close InternalFeatures to find around the TargetShape.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter allows you to select the field names of the column data you wish to return with each Feature.
distanceLimits Double<!– System.Double –> Limit the maximize distance proximately to search closest records.
unitOfDistance DistanceUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit –> The unit of distanceLimits parameter.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesNearestTo(Feature, GeographyUnit, Int32, ReturningColumnsType)

This method returns a user defined number of InternalFeatures that are closest to the TargetFeature.

Remarks

This method returns a user defined number of InternalFeatures 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided create a small bounding box around the TargetShape and then queries the features inside of it. If we reach the number of items to find, then we measure the returned InternalFeatures to find the nearest. If we do not find enough records, we scale up the bounding box and try again. As you can see, this is not the most efficient method. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesNearestCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a user defined number of InternalFeatures that are closest to the TargetFeature.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter is the feature you want to find close InternalFeatures to.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the TargetShape and the FeatureSource are in, such as feet, meters, etc.
numberOfItemsToFind Int32<!– System.Int32 –> This parameter defines how many close InternalFeatures to find around the feature.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesNearestTo(Feature, GeographyUnit, Int32, IEnumerable<String>)

This method returns a user defined number of InternalFeatures that are closest to the TargetFeature.

Remarks

This method returns a user defined number of InternalFeatures 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided create a small bounding box around the TargetShape and then queries the features inside of it. If we reach the number of items to find, then we measure the returned InternalFeatures to find the nearest. If we do not find enough records, we scale up the bounding box and try again. As you can see, this is not the most efficient method. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesNearestCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a user defined number of InternalFeatures that are closest to the TargetFeature.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter is the feature you want to find close InternalFeatures to.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the TargetShape and the FeatureSource are in, such as feet, meters, etc.
numberOfItemsToFind Int32<!– System.Int32 –> This parameter defines how many close InternalFeatures to find around the feature.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesOutsideBoundingBox(RectangleShape, IEnumerable<String>)

This method returns all of the InternalFeatures that are outside of the boundingBox.

Overloads

This method returns all of the features that are outside of the target rectangle shape.

Remarks

This method returns all of the InternalFeatures that are outside of the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that are outside of the target rectangle shape.

Parameters

Name Type Description
boundingBox RectangleShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.RectangleShape –> This parameter specifies the target boundingBox used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesOutsideBoundingBox(RectangleShape, ReturningColumnsType)

This method returns all of the InternalFeatures that are outside of the boundingBox.

Overloads

This method returns all of the features that are outside of the target rectangle shape.

Remarks

This method returns all of the InternalFeatures that are outside of the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that are outside of the target rectangle shape.

Parameters

Name Type Description
boundingBox RectangleShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.RectangleShape –> This parameter specifies the target boundingBox used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesOverlapping(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures that overlap the target Feature.

Overloads

This method returns all of the features that overlap the target shape.

Remarks

This method returns all of the InternalFeatures that overlap the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Overlapping</strong> - The Geometries share some but not all points in common, and the intersection has the same dimension as the Geometries themselves.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesOverlapping(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that overlap the target Feature.

Overloads

This method returns all of the features that overlap the target shape.

Remarks

This method returns all of the InternalFeatures that overlap the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Overlapping</strong> - The Geometries share some but not all points in common, and the intersection has the same dimension as the Geometries themselves.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesOverlapping(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures that overlap the target Feature.

Overloads

This method returns all of the features that overlap the target shape.

Remarks

This method returns all of the InternalFeatures that overlap the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Overlapping</strong> - The Geometries share some but not all points in common, and the intersection has the same dimension as the Geometries themselves.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesOverlapping(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures that overlap the target Feature.

Overloads

This method returns all of the features that overlap the target shape.

Remarks

This method returns all of the InternalFeatures that overlap the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

<strong>Overlapping</strong> - The Geometries share some but not all points in common, and the intersection has the same dimension as the Geometries themselves.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTopologicalEqual(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures that topologicalEqual the target Feature.

Overloads

This method returns all of the features that topologicalEqual the target shape.

Remarks

This method returns all of the InternalFeatures that topologicalEqual the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTopologicalEqual(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures that topologicalEqual the target Feature.

Overloads

This method returns all of the features that topologicalEqual the target shape.

Remarks

This method returns all of the InternalFeatures that topologicalEqual the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTopologicalEqual(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that topologicalEqual the target Feature.

Overloads

This method returns all of the features that topologicalEqual the target shape.

Remarks

This method returns all of the InternalFeatures that topologicalEqual the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTopologicalEqual(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures that topologicalEqual the target Feature.

Overloads

This method returns all of the features that topologicalEqual the target shape.

Remarks

This method returns all of the InternalFeatures that topologicalEqual the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTouching(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures that touch the target Feature.

Overloads

This method returns all of the features that touch the target shape.

Remarks

This method returns all of the InternalFeatures that touch the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTouching(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that touch the target Feature.

Overloads

This method returns all of the features that touch the target shape.

Remarks

This method returns all of the InternalFeatures that touch the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTouching(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures that touch the target Feature.

Overloads

This method returns all of the features that touch the target shape.

Remarks

This method returns all of the InternalFeatures that touch the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesTouching(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures that touch the target Feature.

Overloads

This method returns all of the features that touch the target shape.

Remarks

This method returns all of the InternalFeatures that touch the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithin(BaseShape, ReturningColumnsType)

This method returns all of the InternalFeatures that are within the target Feature.

Overloads

This method returns all of the features that are within the target shape.

Remarks

This method returns all of the InternalFeatures that are within the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithin(Feature, ReturningColumnsType)

This method returns all of the InternalFeatures that are within the target Feature.

Overloads

This method returns all of the features that are within the target shape.

Remarks

This method returns all of the InternalFeatures that are within the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithin(Feature, IEnumerable<String>)

This method returns all of the InternalFeatures that are within the target Feature.

Overloads

This method returns all of the features that are within the target shape.

Remarks

This method returns all of the InternalFeatures that are within the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This parameter specifies the target feature used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithin(BaseShape, IEnumerable<String>)

This method returns all of the InternalFeatures that are within the target Feature.

Overloads

This method returns all of the features that are within the target shape.

Remarks

This method returns all of the InternalFeatures that are within the target shape. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

Return Value

Return Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> The return value is a collection of InternalFeatures that match the spatial query you executed based on the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter specifies the target shape used in the spatial query.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter specifies the column values in the return features.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithinDistanceOf(Feature, GeographyUnit, DistanceUnit, Double, ReturningColumnsType)

This method returns a collection of InternalFeatures that are within a certain distance of the TargetFeature.

Remarks

This method returns a collection of InternalFeatures that are within a certain distance of 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided creates a bounding box around the TargetShape using the distance supplied and then queries the features inside of it. This may not be the most efficient method for this operation. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesWithinDistanceOfCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a collection of InternalFeatures that are within a certain distance of the TargetFeature.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> The feature you wish to find InternalFeatures within a distance of.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the FeatureSource and TargetShape are in.
distanceUnit DistanceUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit –> This parameter specifies the unit of the distance parameter, such as feet, miles, kilometers, etc..
distance Double<!– System.Double –> This parameter specifies the distance in which to find InternalFeatures around the TargetShape.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithinDistanceOf(BaseShape, GeographyUnit, DistanceUnit, Double, ReturningColumnsType)

This method returns a collection of InternalFeatures that are within a certain distance of the TargetShape.

Remarks

This method returns a collection of InternalFeatures that are within a certain distance of 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided creates a bounding box around the TargetShape using the distance supplied and then queries the features inside of it. This may not be the most efficient method for this operation. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesWithinDistanceOfCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a collection of InternalFeatures that are within a certain distance of the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> The shape you wish to find InternalFeatures within a distance of.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the FeatureSource and TargetShape are in.
distanceUnit DistanceUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit –> This parameter specifies the unit of the distance parameter, such as feet, miles, kilometers, etc.
distance Double<!– System.Double –> This parameter specifies the distance in which to find InternalFeatures around the TargetShape.
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithinDistanceOf(Feature, GeographyUnit, DistanceUnit, Double, IEnumerable<String>)

This method returns a collection of InternalFeatures that are within a certain distance of the TargetFeature.

Remarks

This method returns a collection of InternalFeatures that are within a certain distance of 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided creates a bounding box around the TargetShape using the distance supplied and then queries the features inside of it. This may not be the most efficient method for this operation. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesWithinDistanceOfCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a collection of InternalFeatures that are within a certain distance of the TargetFeature.

Parameters

Name Type Description
targetFeature Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> The feature you wish to find InternalFeatures within a distance of.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the FeatureSource and TargetShape are in.
distanceUnit DistanceUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit –> This parameter specifies the unit of the distance parameter, such as feet, miles, kilometers, etc.
distance Double<!– System.Double –> This parameter specifies the distance in which to find InternalFeatures around the TargetShape.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetFeaturesWithinDistanceOf(BaseShape, GeographyUnit, DistanceUnit, Double, IEnumerable<String>)

This method returns a collection of InternalFeatures that are within a certain distance of the TargetShape.

Remarks

This method returns a collection of InternalFeatures that are within a certain distance of 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. If there is a current transaction and it is marked as live, then the results will include any transaction Feature that applies.

The implementation we provided creates a bounding box around the TargetShape using the distance supplied and then queries the features inside of it. This may not be the most efficient method for this operation. If your underlying data provider exposes a more efficient way, we recommend you override the Core version of this method and implement it.

The default implementation of GetFeaturesWithinDistanceOfCore uses the GetFeaturesInsideBoundingBoxCore method for speed. We strongly recommend that you provide your own implementation for this method that will be more efficient. When you override the GetFeaturesInsideBoundingBoxCore method, we recommend that you use any spatial indexes you have at your disposal to make this method as fast as possible.

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 Type Description
Collection<Feature><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WindowsPhoneCore.Feature} –> This method returns a collection of InternalFeatures that are within a certain distance of the TargetShape.

Parameters

Name Type Description
targetShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> The shape you wish to find InternalFeatures within a distance of.
unitOfData GeographyUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.GeographyUnit –> This parameter is the unit of data that the FeatureSource and TargetShape are in.
distanceUnit DistanceUnit<!– ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit –> This parameter specifies the unit of the distance parameter, such as feet, miles, kilometers, etc.
distance Double<!– System.Double –> This parameter specifies the distance in which to find InternalFeatures around the TargetShape.
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter allows you to select the field names of the column data you wish to return with each Feature.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

GetHashCode()

Return Value

Return Type Description
Int32<!– System.Int32 –>

Parameters

Name Type Description

<!– System.Object –> Go Back

GetType()

Return Value

Return Type Description
Type<!– System.Type –>

Parameters

Name Type Description

<!– System.Object –> Go Back

ToString()

Return Value

Return Type Description
String<!– System.String –>

Parameters

Name Type Description

<!– System.Object –> Go Back

Protected Methods

Finalize()

Return Value

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– System.Object –> Go Back

MemberwiseClone()

Return Value

Return Type Description
Object<!– System.Object –>

Parameters

Name Type Description

<!– System.Object –> Go Back

Public Properties

CanExecuteSqlQuery

This property specifies whether FeatureSource can excute a SQL query or not. If it is false, then it will throw an exception when the following APIs are called: ExecuteScalar, ExecuteNonQuery, ExecuteQuery

Remarks

The default implementation is false.

Return Value

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.WindowsPhoneCore.QueryTools –> Go Back

Protected Properties

Public Events

thinkgeo.mapsuite.windowsphonecore.querytools.txt · Last modified: 2017/03/16 21:59 (external edit)