OSID - osid.mapping.path.IntersectionQuery Service Interface Definition

Interface	osid.mapping.path.IntersectionQuery
Implements	`osid.OsidObjectQuery`
Implements	`osid.OsidAggregateableQuery`
Used By	`osid.mapping.path.IntersectionQuerySession`
	`osid.mapping.path.IntersectionSearchSession`
	`osid.mapping.path.IntersectionSmartMapSession`
Description	This is the query for searching intersections. Each method match specifies an `AND` term while multiple invocations of the same method produce a nested `OR`.
Method	matchCoordinate
Description	Match intersections overlapping with the given coordinate.
Parameters	`osid.mapping.Coordinate`	`coordinate`	a coordinate
Parameters	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`coordinate` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearCoordinateTerms
Description	Clears the coordinate query terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchContainingSpatialUnit
Description	Matches intersections within the specified `SpatialUnit`.
Parameters	`osid.mapping.SpatialUnit`	`spatialUnit`	a spatial unit
Parameters	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`spatialUnit` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearContainingSpatialUnitTerms
Description	Clears the spatial unit terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchPathId
Description	Sets the path `Id` for this query to match routes using a designated path.
Parameters	`osid.id.Id`	`pathId`	the path `Id`
Parameters	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`pathId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearPathIdTerms
Description	Clears the path `Id` query terms.
Compliance	`mandatory`		This method must be implemented.
Method	supportsPathQuery
Description	Tests if a `PathQuery` is available.
Return	`boolean`		`true` if a path query is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getPathQuery
Description	Gets the query for a path. Multiple retrievals produce a nested `OR` term.
Return	`osid.mapping.path.PathQuery`		the path query
Errors	UNIMPLEMENTED		`supportsPathQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPathQuery()` is `true`.
Method	matchAnyPath
Description	Matches intersections with any designated path.
Parameters	`boolean`	`match`	`true` to match routes with any path, `false` to match routes with no path
Compliance	`mandatory`		This method must be implemented.
Method	clearPathTerms
Description	Clears the path query terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchRotary
Description	Matches rotaries.
Parameters	`boolean`	`match`	`true` to match rotaries, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	clearRotaryTerms
Description	Clears the rotary query terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchFork
Description	Matches forks.
Parameters	`boolean`	`match`	`true` to match forks, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	clearForkTerms
Description	Clears the fork query terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchMapId
Description	Sets the map `Id` for this query to match routes assigned to maps.
Parameters	`osid.id.Id`	`mapId`	the map `Id`
Parameters	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`mapId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearMapIdTerms
Description	Clears the map `Id` query terms.
Compliance	`mandatory`		This method must be implemented.
Method	supportsMapQuery
Description	Tests if a `MapQuery` is available.
Return	`boolean`		`true` if a map query is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getMapQuery
Description	Gets the query for a map. Multiple retrievals produce a nested `OR` term.
Return	`osid.mapping.MapQuery`		the map query
Errors	UNIMPLEMENTED		`supportsMapQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsMapQuery()` is `true`.
Method	clearMapTerms
Description	Clears the map query terms.
Compliance	`mandatory`		This method must be implemented.
Method	getIntersectionQueryRecord
Description	Gets the intersection query record corresponding to the given `Intersection` record `Type`. Multiple record retrievals produce a nested `OR` term.
Parameters	`osid.type.Type`	`intersectionRecordType`	an intersection record type
Return	`osid.mapping.path.records.IntersectionQueryRecord`		the intersection query record
Errors	NULL_ARGUMENT		`intersectionRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(intersectionRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.