cgetPlaces method
Future<Response<PlacePagination> >
cgetPlaces({
- required String xKeyclicApp,
- String? acceptLanguage,
- DateTime? xDateTime,
- String? xKeyclicAppPlatform,
- String? xKeyclicAppVersion,
- List<
String> ? orderLeftSquareBracketRightSquareBracket, - String? branchCode,
- String? businessActivity,
- List<
String> ? businessActivitiesLeftSquareBracketRightSquareBracket, - DateTime? after,
- DateTime? before,
- String? geoElevation,
- List<
String> ? geoHashLeftSquareBracketRightSquareBracket, - String? geoPoint,
- String? geoCoordinates,
- String? leaf,
- String? level,
- String? organization,
- List<
String> ? organizationsLeftSquareBracketRightSquareBracket, - String? parent,
- List<
String> ? parentsLeftSquareBracketRightSquareBracket, - String? query,
- int? page,
- int? limit,
- CancelToken? cancelToken,
- Map<
String, dynamic> ? headers, - Map<
String, dynamic> ? extra, - ValidateStatus? validateStatus,
- ProgressCallback? onSendProgress,
- ProgressCallback? onReceiveProgress,
Retrieve all Place resources.
Parameters:
xKeyclicApp
acceptLanguage
xDateTime
xKeyclicAppPlatform
xKeyclicAppVersion
orderLeftSquareBracketRightSquareBracket
branchCode
businessActivity
businessActivitiesLeftSquareBracketRightSquareBracket
after
before
geoElevation
geoHashLeftSquareBracketRightSquareBracket
geoPoint
- One latitude and one longitude serialized and separated by a plus or a minus sign.geoCoordinates
- One latitude and one longitude serialized and separated by a plus or a minus sign.leaf
level
organization
organizationsLeftSquareBracketRightSquareBracket
parent
parentsLeftSquareBracketRightSquareBracket
query
page
- Page of the overview.limit
- Page of the overview.cancelToken
- ACancelToken
that can be used to cancel the operationheaders
- Can be used to add additional headers to the requestextras
- Can be used to add flags to the requestvalidateStatus
- AValidateStatus
callback that can be used to determine request success based on the HTTP status of the responseonSendProgress
- AProgressCallback
that can be used to get the send progressonReceiveProgress
- AProgressCallback
that can be used to get the receive progress
Returns a Future containing a Response
with a PlacePagination as data
Throws DioError
if API call or serialization fails
Keyclic API documentation.
Also see Retrieve all Place resources. Documentation
Implementation
Future<Response<PlacePagination>> cgetPlaces({
required String xKeyclicApp,
String? acceptLanguage,
DateTime? xDateTime,
String? xKeyclicAppPlatform,
String? xKeyclicAppVersion,
List<String>? orderLeftSquareBracketRightSquareBracket,
String? branchCode,
String? businessActivity,
List<String>? businessActivitiesLeftSquareBracketRightSquareBracket,
DateTime? after,
DateTime? before,
String? geoElevation,
List<String>? geoHashLeftSquareBracketRightSquareBracket,
String? geoPoint,
String? geoCoordinates,
String? leaf,
String? level,
String? organization,
List<String>? organizationsLeftSquareBracketRightSquareBracket,
String? parent,
List<String>? parentsLeftSquareBracketRightSquareBracket,
String? query,
int? page,
int? limit,
CancelToken? cancelToken,
Map<String, dynamic>? headers,
Map<String, dynamic>? extra,
ValidateStatus? validateStatus,
ProgressCallback? onSendProgress,
ProgressCallback? onReceiveProgress,
}) async {
final String path = r'/places';
final options = Options(
method: r'GET',
headers: <String, dynamic>{
// to string ??
if (acceptLanguage != null) r'accept-language': acceptLanguage,
if (xDateTime != null) r'x-date-time': xDateTime,
r'x-keyclic-app': xKeyclicApp,
if (xKeyclicAppPlatform != null)
r'x-keyclic-app-platform': xKeyclicAppPlatform,
if (xKeyclicAppVersion != null)
r'x-keyclic-app-version': xKeyclicAppVersion,
...?headers,
},
extra: <String, dynamic>{
'secure': <Map<String, String>>[
{
'type': 'apiKey',
'name': 'bearer',
'keyName': 'Authorization',
'where': 'header',
},
],
...?extra,
},
validateStatus: validateStatus,
);
final queryParameters = <String, dynamic>{
if (orderLeftSquareBracketRightSquareBracket != null)
r'order[]': encodeCollectionQueryParameter(
orderLeftSquareBracketRightSquareBracket,
format: ListFormat.multi),
if (branchCode != null) r'branch_code': encodeQueryParameter(branchCode),
if (businessActivity != null)
r'business_activity': encodeQueryParameter(businessActivity),
if (businessActivitiesLeftSquareBracketRightSquareBracket != null)
r'business_activities[]': encodeCollectionQueryParameter(
businessActivitiesLeftSquareBracketRightSquareBracket,
format: ListFormat.multi),
if (after != null) r'after': encodeQueryParameter(after),
if (before != null) r'before': encodeQueryParameter(before),
if (geoElevation != null)
r'geo_elevation': encodeQueryParameter(geoElevation),
if (geoHashLeftSquareBracketRightSquareBracket != null)
r'geo_hash[]': encodeCollectionQueryParameter(
geoHashLeftSquareBracketRightSquareBracket,
format: ListFormat.multi),
if (geoPoint != null) r'geo_point': encodeQueryParameter(geoPoint),
if (geoCoordinates != null)
r'geo_coordinates': encodeQueryParameter(geoCoordinates),
if (leaf != null) r'leaf': encodeQueryParameter(leaf),
if (level != null) r'level': encodeQueryParameter(level),
if (organization != null)
r'organization': encodeQueryParameter(organization),
if (organizationsLeftSquareBracketRightSquareBracket != null)
r'organizations[]': encodeCollectionQueryParameter(
organizationsLeftSquareBracketRightSquareBracket,
format: ListFormat.multi),
if (parent != null) r'parent': encodeQueryParameter(parent),
if (parentsLeftSquareBracketRightSquareBracket != null)
r'parents[]': encodeCollectionQueryParameter(
parentsLeftSquareBracketRightSquareBracket,
format: ListFormat.multi),
if (query != null) r'query': encodeQueryParameter(query),
if (page != null) r'page': encodeQueryParameter(page),
if (limit != null) r'limit': encodeQueryParameter(limit),
};
final response = await _apiClient.dio.request<Object>(
path,
options: options,
queryParameters: queryParameters,
cancelToken: cancelToken,
onSendProgress: onSendProgress,
onReceiveProgress: onReceiveProgress,
);
PlacePagination responseData;
try {
responseData = await _apiClient.deserializeAsync<PlacePagination>(
response.data!, 'PlacePagination');
} catch (error, stackTrace) {
throw DioError(
requestOptions: response.requestOptions,
response: response,
type: DioErrorType.other,
error: error,
)..stackTrace = stackTrace;
}
return Response<PlacePagination>(
data: responseData,
headers: response.headers,
isRedirect: response.isRedirect,
requestOptions: response.requestOptions,
redirects: response.redirects,
statusCode: response.statusCode,
statusMessage: response.statusMessage,
extra: response.extra,
);
}