searchInArea static method
- RectangleGeographicArea area,
- Coordinates referenceCoordinates,
- void onComplete(), {
- String textFilter = '',
- SearchPreferences? preferences,
Search for landmarks within a geographic area.
Retrieves landmarks within area, ordered by relevance to referenceCoordinates.
Parameters
area: The rectangular geographic area to search within.referenceCoordinates: The reference position for result relevance ordering.onComplete: Callback invoked when the search completes. Provides:err: The result status. Possible values:- GemError.success: Search completed successfully with results.
- GemError.reducedResult: Search completed successfully but only a subset of results was returned.
- GemError.cancel: Search canceled by user.
- GemError.noMemory: Insufficient memory for operation.
- GemError.operationTimeout: Operation timeout on online service (typically > 1 min).
- GemError.networkFailed: Network failure during online search.
results: List of found landmarks (empty on error).
textFilter: Optional text filter to narrow results. Defaults to empty string.preferences: Optional SearchPreferences to customize search behavior.
Returns
- TaskHandler?: TaskHandler for this operation if search could be started; otherwise null.
See also:
- RectangleGeographicArea - Defines the geographic area for the search.
Implementation
static TaskHandler? searchInArea(
final RectangleGeographicArea area,
final Coordinates referenceCoordinates,
final void Function(GemError err, List<Landmark> results) onComplete, {
final String textFilter = '',
SearchPreferences? preferences,
}) {
preferences ??= SearchPreferences();
final EventDrivenProgressListener progListener =
EventDrivenProgressListener();
GemKitPlatform.instance.registerEventHandler(progListener.id, progListener);
final LandmarkList results = LandmarkList();
progListener.registerOnCompleteWithData((
final int err,
final String hint,
final Map<dynamic, dynamic> json,
) {
GemKitPlatform.instance.unregisterEventHandler(progListener.id);
if (err == GemError.success.code || err == GemError.reducedResult.code) {
onComplete(GemErrorExtension.fromCode(err), results.toList());
} else {
onComplete(GemErrorExtension.fromCode(err), <Landmark>[]);
}
});
final OperationResult resultString = staticMethod(
'SearchService',
'searchInArea',
args: <String, dynamic>{
'results': results.pointerId,
'listener': progListener.id,
'textFilter': textFilter,
'referenceCoordinates': referenceCoordinates,
'preferences': preferences.pointerId,
'area': area,
},
);
final GemError errorCode = GemErrorExtension.fromCode(
resultString['result'],
);
if (errorCode != GemError.success) {
onComplete(errorCode, <Landmark>[]);
return null;
}
return TaskHandlerImpl(progListener.id);
}