随着外卖业务的发展，外卖配送范围功能成为了外卖点餐系统中一个非常重要的功能点。为了满足用户的需求，很多外卖平台都会提供这样一个功能。那么如何利用Go语言开发这个配送范围功能呢？本文将详细介绍这个过程，并提供具体的代码示例，以便读者更好地了解和掌握这个功能的实现方式。
- 前置条件
在开始开发之前，我们需要先了解一下这个功能的需求和实现方式。具体而言：
- 需要给出一个多边形区域，即外卖配送的服务范围；
- 当用户在下单页面输入地址时，需要通过用户所在的定位，判断是否在服务范围之内，从而决定是否接单。
为了实现这个功能，我们需要使用一些工具和技术：
- 首先，我们需要使用一个地图API服务，来获取我们需要的服务范围数据和用户所在位置的地理信息。
- 其次，我们需要使用多边形算法，即点在多边形内算法，来判断定位点是否在服务范围内。
- 最后，我们需要将这些工具封装成一个代码库，以便在点餐系统中使用。
- 设计思路
在实现这个功能之前，我们需要先定义一些基本的数据结构和接口：
- 多边形区域：一个数组，存储了多个点的地理信息；
- 点：一个结构体，包含经纬度信息；
- 客户端请求：包含用户地址信息。
然后，我们可以按照以下的设计思路来实现这个功能：
- 使用一个地图API服务，获取多边形区域的地理信息，并将这些信息存储在一个数组中；
- 解析客户端请求，获取客户端所在位置的地理信息；
- 使用多边形算法，判断客户端位置是否在服务范围内，并给出相应的响应结果。
在Go语言中，我们可以使用go-mapbox库来访问地图API服务。同时，我们也可以使用Go语言中内置的math库，来实现多边形算法。具体代码实现如下：
package main
import (
"fmt"
"math"
"github.com/ustroetz/go-mapbox"
)
type Point struct {
Lat float64
Lng float64
}
type Polygon []Point
func (p Point) ToCoordinates() *mapbox.Coordinates {
return &mapbox.Coordinates{
Longitude: p.Lng,
Latitude: p.Lat,
}
}
func ContainsPointInPolygon(point Point, polygon Polygon) bool {
intersectCount := 0
polygonLength := len(polygon)
if polygonLength < 3 {
return false
}
endPoint := Point{Lat: 9999.0, Lng: point.Lng}
for i := 0; i < len(polygon); i++ {
startPoint := polygon[i]
nextPointIndex := (i + 1) % len(polygon)
nextPoint := polygon[nextPointIndex]
if startPoint.Lng == nextPoint.Lng && endPoint.Lng == startPoint.Lng && (point.Lng == startPoint.Lng && (point.Lat > startPoint.Lat) == (point.Lat < endPoint.Lat)) {
return true
}
if point.Lng > math.Min(startPoint.Lng, nextPoint.Lng) && point.Lng <= math.Max(startPoint.Lng, nextPoint.Lng) {
deltaLat := nextPoint.Lat - startPoint.Lat
if deltaLat == 0 {
continue
}
intersectLat := startPoint.Lat + (point.Lng-startPoint.Lng)*(nextPoint.Lat-startPoint.Lat)/(nextPoint.Lng-startPoint.Lng)
if intersectLat == point.Lat {
return true
}
if intersectLat > point.Lat {
intersectCount++
}
}
}
return intersectCount%2 != 0
}
func InDeliveryArea(point Point, apiKey string) bool {
client := mapbox.New(apiKey)
// 可以使用自己的多边形坐标
geojson, _, _ := client.MapMatching().GetMapMatching(
[]mapbox.Coordinates{
*point.ToCoordinates(),
},
nil,
)
polygon := geojson.Features[0].Geometry.Coordinates[0].([]interface{})
var polygonArray Polygon
for _, item := range polygon {
arr := item.([]interface{})
p := Point{Lat: arr[1].(float64), Lng: arr[0].(float64)}
polygonArray = append(polygonArray, p)
}
fmt.Println("多边形坐标: ", polygonArray)
return ContainsPointInPolygon(point, polygonArray)
}
func main() {
point := Point{
Lat: 31.146922,
Lng: 121.362282,
}
apiKey := "YOUR_ACCESS_TOKEN"
result := InDeliveryArea(point, apiKey)
fmt.Println("坐标是否在配送范围内:", result)
}以上是一个基本的Go语言实现代码示例。在运行这段代码之前，需要首先在地图API后台获取一个Access Token。将Token替换 YOUR_ACCESS_TOKEN即可。另外，还需要在地图API提供的多边形查询接口中输入对应的坐标和相关参数。运行以上代码，可以得到一个代表坐标所在位置是否在服务范围内的布尔值。
- 封装成为可复用库
上述示例代码可以帮助我们完成外卖点餐系统的外卖配送范围功能。但是，在实际应用中，这个功能可能被多个页面或模块所使用。为了避免重复编写代码的麻烦，我们需要将其封装成为一个可复用的库。具体而言：
- 我们可以将上述的InDeliveryArea函数封装成为一个可以从外部调用的函数。
- 另外，我们还可以对外部输入的参数进行检查和校验，以保证程序的健壮性。
例如，我们可以将代码重新组织，把获取多边形和判断点在多边形内两个操作分离，这样也方便后续扩展。
以下是Go语言封装成为可复用库的示例代码：
package delivery
import (
"fmt"
"math"
"github.com/ustroetz/go-mapbox"
)
type Point struct {
Lat float64
Lng float64
}
type Polygon []Point
type DeliveryArea struct {
polygon Polygon
client *mapbox.Client
}
func NewDeliveryArea(apiKey string, polygonArray []Point) *DeliveryArea {
client := mapbox.New(apiKey)
var polygon Polygon
for _, p := range polygonArray {
polygon = append(polygon, p)
}
return &DeliveryArea{polygon: polygon, client: client}
}
func (p Point) ToCoordinates() *mapbox.Coordinates {
return &mapbox.Coordinates{
Longitude: p.Lng,
Latitude: p.Lat,
}
}
func (d *DeliveryArea) containsPoint(point Point) bool {
intersectCount := 0
polygonLength := len(d.polygon)
if polygonLength < 3 {
return false
}
endPoint := Point{Lat: 9999.0, Lng: point.Lng}
for i := 0; i < len(d.polygon); i++ {
startPoint := d.polygon[i]
nextPointIndex := (i + 1) % len(d.polygon)
nextPoint := d.polygon[nextPointIndex]
if startPoint.Lng == nextPoint.Lng && endPoint.Lng == startPoint.Lng && (point.Lng == startPoint.Lng && (point.Lat > startPoint.Lat) == (point.Lat < endPoint.Lat)) {
return true
}
if point.Lng > math.Min(startPoint.Lng, nextPoint.Lng) && point.Lng <= math.Max(startPoint.Lng, nextPoint.Lng) {
deltaLat := nextPoint.Lat - startPoint.Lat
if deltaLat == 0 {
continue
}
intersectLat := startPoint.Lat + (point.Lng-startPoint.Lng)*(nextPoint.Lat-startPoint.Lat)/(nextPoint.Lng-startPoint.Lng)
if intersectLat == point.Lat {
return true
}
if intersectLat > point.Lat {
intersectCount++
}
}
}
return intersectCount%2 != 0
}
func (d *DeliveryArea) Contains(point Point) bool {
resp, _, err := d.client.MapMatching().GetMapMatching(
[]mapbox.Coordinates{
*point.ToCoordinates(),
},
nil,
)
if err != nil {
fmt.Printf("MapMatching error: %s
", err)
return false
}
geojson := resp.Features[0].Geometry.Coordinates[0].([]interface{})
var polygonArray Polygon
for _, item := range geojson {
arr := item.([]interface{})
p := Point{Lat: arr[1].(float64), Lng: arr[0].(float64)}
polygonArray = append(polygonArray, p)
}
return d.containsPoint(point)
}这里我们使用了工厂模式来创建DeliveryArea结构体，可以看到，除了方便使用外，还可以发现它们的内部逻辑相对清晰，继而更易于维护。如下是一个使用上述封装后库的示例代码：
package main
import (
"fmt"
"github.com/username/repo_deliver_area/delivery"
)
func main() {
polygonArray := []delivery.Point{
{Lat: 31.23039, Lng: 121.4737},
{Lat: 31.23886, Lng: 121.50016},
{Lat: 31.19394, Lng: 121.5276},
{Lat: 31.18667, Lng: 121.49978},
}
apiKey := "YOUR_ACCESS_TOKEN"
deliveryArea := delivery.NewDeliveryArea(apiKey, polygonArray)
point := delivery.Point{
Lat: 31.146922,
Lng: 121.362282,
}
result := deliveryArea.Contains(point)
fmt.Println(result)
}在运行这段代码之前，需要先将库文件放置到指定位置，并替换掉Import路径中的username/repo_deliver_area，以及将地图API的Access Token替换掉 YOUR_ACCESS_TOKEN。最终输出将代表坐标所在位置是否在服务范围内的布尔值。
