com.mapbar.navi

类 FourServices

java.lang.Object

com.mapbar.navi.FourServices

public class FourServices
extends java.lang.Object

4S店搜索功能模块

从以下版本开始:

4.9.x

Notice:

注意：此模块需要使用额外的资源文件。

嵌套类概要

嵌套类

限定符和类型	类和说明
class	FourServices.SortRule 4S店排序规则

字段概要

字段

限定符和类型	字段和说明
static int	INVALID_INDEX

方法概要

限定符和类型	方法和说明
void	cleanup() 模块资源清理
java.lang.String[]	getAllBrands() 获取所有的品牌名称
java.lang.String	getCarBrandByIndex(int carBrandIndex) 根据车品牌名称索引获取品牌名称
int	getCarBrandIndex(java.lang.String carBrandName) 根据品牌名称返回品牌名称所在索引位置
java.lang.String	getCarTypeByIndex(int carTypeIndex) 根据索引查找指定类型名称，如果名称不存在，或者索引不是有效值将返回null
int	getCarTypeNumber() 返回当前车类型个数
java.lang.String[]	getCarTypes(int start, int number) 根据索引区间查找指定类型名称，索引区间用开始位置和个数表示，即[start, start + number), 由未初始化等原因导致获取失败时null
static FourServices	getInstance()
FourServicesInfo[]	getResultByIndex(int beginIndex, int endIndex) 已过时。
int	getResultNumber() 获取搜索结果数
FourServicesInfo[]	getResults(int start, int number) 根据索引区间获取搜索的4S店结果，一般用来翻页，索引区间为[start, start + number)
void	init() 模块初始化
boolean	isInited() 是否初始化
void	query(android.graphics.Point carPos, int cityId, java.lang.String type, java.lang.String brand, java.lang.String keyword) 根据关键字搜索车所在位置附近的4S店
void	query(android.graphics.Point carPos, int cityId, java.lang.String type, java.lang.String brand, java.lang.String keyword, int distance) 根据关键字搜索车所在位置附近的4S店，并使用
boolean	queryByBrand(android.graphics.Point pos, int cityId, java.lang.String brand) 根据品牌搜索
boolean	queryByBrand(android.graphics.Point pos, int cityId, java.lang.String brand, int distance) 根据品牌搜索，并使用距离过滤
int	queryCarBrands(java.lang.String carTypeName, java.lang.String initials) 根据车类型名称和品牌名称首字母搜索指定的品牌名称
void	requestSort(int type) 按照指定类型排序结果

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

INVALID_INDEX

public static final int INVALID_INDEX

另请参阅:

常量字段值

方法详细资料

getInstance

public static FourServices getInstance()

isInited

public boolean isInited()

是否初始化

返回:

初始化过则返回true，否则返回false

从以下版本开始:

4.9.x

init

public void init()
          throws java.lang.Exception

模块初始化

抛出:

java.lang.Exception

从以下版本开始:

4.9.x

cleanup

public void cleanup()

模块资源清理

从以下版本开始:

4.9.x

getCarTypeNumber

public int getCarTypeNumber()

返回当前车类型个数

返回:

车类型个数

从以下版本开始:

4.9.x

getCarTypeByIndex

public java.lang.String getCarTypeByIndex(int carTypeIndex)

根据索引查找指定类型名称，如果名称不存在，或者索引不是有效值将返回null

参数:

carTypeIndex - 车类型索引

返回:

车类型名称字符串

从以下版本开始:

4.9.x

另请参阅:

getCarTypeNumber(), getCarTypes(int, int)

getCarTypes

public java.lang.String[] getCarTypes(int start,
                                      int number)

根据索引区间查找指定类型名称，索引区间用开始位置和个数表示，即[start, start + number), 由未初始化等原因导致获取失败时null

参数:

start - 车类型索引

number - 个数

返回:

车类型名称字符串数组

从以下版本开始:

4.9.x

另请参阅:

getCarTypeNumber()

queryCarBrands

public int queryCarBrands(java.lang.String carTypeName,
                          java.lang.String initials)

根据车类型名称和品牌名称首字母搜索指定的品牌名称

参数:

carTypeName - 车类型名称

initials - 品牌名称首字母，如果需要所有的车类型名称所对应的品牌个数，则此参数应该传null

返回:

品牌个数

从以下版本开始:

4.9.x

getCarBrandByIndex

public java.lang.String getCarBrandByIndex(int carBrandIndex)

根据车品牌名称索引获取品牌名称

参数:

carBrandIndex - 品牌名称索引

返回:

品牌名称

从以下版本开始:

4.9.x

另请参阅:

queryCarBrands(String, String)

requestSort

public void requestSort(int type)

按照指定类型排序结果

参数:

type - 排序类型FourServices.SortRule

从以下版本开始:

4.9.x

另请参阅:

FourServices.SortRule

Notice:

注意：此方法仅在有返回结果后调用有效。

query

public void query(android.graphics.Point carPos,
                  int cityId,
                  java.lang.String type,
                  java.lang.String brand,
                  java.lang.String keyword)

根据关键字搜索车所在位置附近的4S店

参数:

carPos - 车所在位置

cityId - 所在城市及区县Id，如果输入城市以上级别id将没有结果，一般是通过WorldManager相关方法获取的

type - 车类型

brand - 搜索的汽车品牌名称

keyword - 搜索的关键字，关键字可以为空

从以下版本开始:

4.9.x

query

public void query(android.graphics.Point carPos,
                  int cityId,
                  java.lang.String type,
                  java.lang.String brand,
                  java.lang.String keyword,
                  int distance)

根据关键字搜索车所在位置附近的4S店，并使用

参数:

carPos - 车所在位置

cityId - 所在城市及区县Id，如果输入城市以上级别id将没有结果，一般是通过WorldManager相关方法获取的

type - 车类型

brand - 搜索的汽车品牌名称

keyword - 搜索的关键字，关键字可以为空

distance - 距离过滤限制，单位：米

从以下版本开始:

4.9.x

getResultNumber

public int getResultNumber()

获取搜索结果数

返回:

搜索结果数量

从以下版本开始:

4.9.x

另请参阅:

getResults(int, int)

getResultByIndex

public FourServicesInfo[] getResultByIndex(int beginIndex,
                                           int endIndex)

已过时。

根据索引获取搜索的4S店结果，一般用来翻页

参数:

beginIndex - 起始索引，从0开始

endIndex - 终止索引

返回:

[beginIndex, endIndex)之间的所有结果FourServicesInfo，如果输入的索引有问题或未初始化返回null

从以下版本开始:

4.9.x

另请参阅:

FourServicesInfo

getResults

public FourServicesInfo[] getResults(int start,
                                     int number)

根据索引区间获取搜索的4S店结果，一般用来翻页，索引区间为[start, start + number)

参数:

start - 起始索引，从0开始

number - 个数

返回:

区间内的所有结果FourServicesInfo，由未初始化等原因导致获取失败时null

从以下版本开始:

4.9.x

另请参阅:

getResultNumber()

getCarBrandIndex

public int getCarBrandIndex(java.lang.String carBrandName)

根据品牌名称返回品牌名称所在索引位置

参数:

carBrandName - 品牌名称

返回:

品牌名称对应的在表中的索引位置，如果获取失败则返回无效索引INVALID_INDEX

getAllBrands

public java.lang.String[] getAllBrands()

获取所有的品牌名称

返回:

品牌名称数组

queryByBrand

public boolean queryByBrand(android.graphics.Point pos,
                            int cityId,
                            java.lang.String brand)

根据品牌搜索

参数:

pos - 车所在位置

cityId - 所在城市Id

brand - 品牌

返回:

如果搜索成功返回true，否则返回false

queryByBrand

public boolean queryByBrand(android.graphics.Point pos,
                            int cityId,
                            java.lang.String brand,
                            int distance)

根据品牌搜索，并使用距离过滤

参数:

pos - 车所在位置

cityId - 所在城市Id

brand - 品牌

distance - 过滤距离，单位：米

返回:

如果搜索成功返回true，否则返回false