本期分享专家：夏苜，一直从事oss、cdn、ram、开放搜索等产品的技术支持，虽然是女子，对技术也有一颗执著的心。爱技术，爱分享。本期的分享专题—开放搜索相关性函数distance的应用
Distance, 是距离的意思，但是在技术函数的世界里，它可以计算距离。
你在点外卖，distance在计算着你和商家的距离；
你在打车，distance在计算着你和司机的距离；
你在找朋友，distance在计算着你和朋友间的距离；
你在生活，distance在计算。
原来生活中看似常用的功能是被这个神奇的函数distance在计算着，这是如何实现的？
Distance函数是什么样的，我们先来简单介绍并了解下他的结构。
- 简介：
distance 函数用来获取两个点之间的球面距离。一般用于LBS的距离计算，兼有function及feature的功能，可以同时在filter、sort及formula精排表达式中使用。
- 函数结构:
distance(longitude_a, latitude_a, longtitude_b, latitude_b, output_name)
其中
longitude_a, latitude_a表示a点的经纬度，支持的参数类型为浮点型的字段名。这两个数据是需要从开放搜索文档中获取的固定数据，所以应用结构中需要有两个浮点型类型（flout，double）的字段。
longtitude_b, latitude_b表示b点的经纬度，也需要是浮点型，在搜索条件中输入的数据。当在精排表达式中使用时，可以通过kvpairs进行参数的传递。
outputname是返回值,计算距离，float类型，单位为千米。仅限于精排表达式中使用，filter及sort子句不支持。设置outputname参数后，实际的距离值将展示到variableValue节点中，该节点只能在返回格式为xml或者fulljson中（config子句中format参数可以设置）才能得到。
- 在使用前我们也要做好准备工作：
1、创建开放搜索应用，应用结构中需要有两个浮点型类型字段存储a点的经纬度。我这里设置了字段lng和lat，当然double也可以。导入a点信息以及位置坐标。
2、我们测试下如果在distance中两个参数不是浮点型字段的情况：
category是int类型，报错sort表达式语法有误：6139 Sort expression syntax error.
- 用一个点外卖的过程让你秒懂distance的应用：
1. 确定用户坐标（120.34256,30.56982），以用户坐标为中心按照距离由近及远排序来展示满足您需求的商家。用distance是这样实现的：
sort= +distance(lng,lat,"120.34256","30.56982")
在显示中通过查看排序分可以看到计算的距离。
注意：在sort中没有引进RANK，粗排和精排设置是不生效的，具体可以参考sort子句的介绍。
2. 在已经展示的商家里面继续提出更高的要求，要求展示客户附近200km范围内的商家。看看怎么实现？
sort= +distance(lng,lat,"120.34256","30.56982")
filter= distance(lng,lat,"120.34256","30.56982")<200
3. 接下来我想了解商家到底距离我有多远？即在获取到1和2的展示结果上显示出实际距离值。
通过上面介绍了解到，距离值只能通过精排表达式来获取。那么我们来设置下精排表达式，先测试下将sort排序放在精排表达式中：
将distance1精排表达式设置为
distance(lng, lat, 120.34256,30.56982)
sort=+RANK；
这个时候排序分中就会出现粗排和精排的结果了
下面测试精排中加上距离返回值的情况：
将distance2精排表达式设置为
distance(lng, lat, 120.34256,30.56982,distance_value)
sort=+RANK；
config=start:0,hit:10,format:fulljson；
查看variableValue的内容即可获取返回的距离值
4、 订餐的过程中，当然是允许客户是移动的，这个时候需要将变化的位置进行传送，distance是这么表达
一般在精排表达式中不会设置固定的距离值，每个用户的位置可能不同，如果要经常变化精排表达式不太合适。这样就用到了传参kvpairs子句。
将distance3精排表达式设置为
distance(lng, lat,lng_b, lat_b, distance_value)
sort=+RANK；
config=start:0,hit:10,format:fulljson；
kvpairs=lng_b:120.34256,lat_b:30.56982
上面的过程完美的使用dinstance函数实现了客户和商家之间的距离测量，你学会了吗？
本期分享结束啦 ，欢迎大家留言讨论，对distance有什么看法，想了解哪些技术？统统说出来，下期再见。
