隨著外賣業(yè)務(wù)的發(fā)展,外賣配送范圍功能成為了外賣點(diǎn)餐系統(tǒng)中一個(gè)非常重要的功能點(diǎn)。為了滿足用戶的需求,很多外賣平臺(tái)都會(huì)提供這樣一個(gè)功能。那么如何利用Go語(yǔ)言開發(fā)這個(gè)配送范圍功能呢?本文將詳細(xì)介紹這個(gè)過程,并提供具體的代碼示例,以便讀者更好地了解和掌握這個(gè)功能的實(shí)現(xiàn)方式。
- 前置條件
在開始開發(fā)之前,我們需要先了解一下這個(gè)功能的需求和實(shí)現(xiàn)方式。具體而言:
需要給出一個(gè)多邊形區(qū)域,即外賣配送的服務(wù)范圍;當(dāng)用戶在下單頁(yè)面輸入地址時(shí),需要通過用戶所在的定位,判斷是否在服務(wù)范圍之內(nèi),從而決定是否接單。
為了實(shí)現(xiàn)這個(gè)功能,我們需要使用一些工具和技術(shù):
首先,我們需要使用一個(gè)地圖API服務(wù),來獲取我們需要的服務(wù)范圍數(shù)據(jù)和用戶所在位置的地理信息。其次,我們需要使用多邊形算法,即點(diǎn)在多邊形內(nèi)算法,來判斷定位點(diǎn)是否在服務(wù)范圍內(nèi)。最后,我們需要將這些工具封裝成一個(gè)代碼庫(kù),以便在點(diǎn)餐系統(tǒng)中使用。
- 設(shè)計(jì)思路
在實(shí)現(xiàn)這個(gè)功能之前,我們需要先定義一些基本的數(shù)據(jù)結(jié)構(gòu)和接口:
多邊形區(qū)域:一個(gè)數(shù)組,存儲(chǔ)了多個(gè)點(diǎn)的地理信息;點(diǎn):一個(gè)結(jié)構(gòu)體,包含經(jīng)緯度信息;客戶端請(qǐng)求:包含用戶地址信息。
然后,我們可以按照以下的設(shè)計(jì)思路來實(shí)現(xiàn)這個(gè)功能:
使用一個(gè)地圖API服務(wù),獲取多邊形區(qū)域的地理信息,并將這些信息存儲(chǔ)在一個(gè)數(shù)組中;解析客戶端請(qǐng)求,獲取客戶端所在位置的地理信息;使用多邊形算法,判斷客戶端位置是否在服務(wù)范圍內(nèi),并給出相應(yīng)的響應(yīng)結(jié)果。
在Go語(yǔ)言中,我們可以使用go-mapbox庫(kù)來訪問地圖API服務(wù)。同時(shí),我們也可以使用Go語(yǔ)言中內(nèi)置的math庫(kù),來實(shí)現(xiàn)多邊形算法。具體代碼實(shí)現(xiàn)如下:
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)
// 可以使用自己的多邊形坐標(biāo)
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("多邊形坐標(biāo): ", 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("坐標(biāo)是否在配送范圍內(nèi):", result)
}
登錄后復(fù)制
以上是一個(gè)基本的Go語(yǔ)言實(shí)現(xiàn)代碼示例。在運(yùn)行這段代碼之前,需要首先在地圖API后臺(tái)獲取一個(gè)Access Token。將Token替換 YOUR_ACCESS_TOKEN即可。另外,還需要在地圖API提供的多邊形查詢接口中輸入對(duì)應(yīng)的坐標(biāo)和相關(guān)參數(shù)。運(yùn)行以上代碼,可以得到一個(gè)代表坐標(biāo)所在位置是否在服務(wù)范圍內(nèi)的布爾值。
- 封裝成為可復(fù)用庫(kù)
上述示例代碼可以幫助我們完成外賣點(diǎn)餐系統(tǒng)的外賣配送范圍功能。但是,在實(shí)際應(yīng)用中,這個(gè)功能可能被多個(gè)頁(yè)面或模塊所使用。為了避免重復(fù)編寫代碼的麻煩,我們需要將其封裝成為一個(gè)可復(fù)用的庫(kù)。具體而言:
我們可以將上述的InDeliveryArea函數(shù)封裝成為一個(gè)可以從外部調(diào)用的函數(shù)。另外,我們還可以對(duì)外部輸入的參數(shù)進(jìn)行檢查和校驗(yàn),以保證程序的健壯性。
例如,我們可以將代碼重新組織,把獲取多邊形和判斷點(diǎn)在多邊形內(nèi)兩個(gè)操作分離,這樣也方便后續(xù)擴(kuò)展。
以下是Go語(yǔ)言封裝成為可復(fù)用庫(kù)的示例代碼:
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)
}
登錄后復(fù)制
這里我們使用了工廠模式來創(chuàng)建DeliveryArea結(jié)構(gòu)體,可以看到,除了方便使用外,還可以發(fā)現(xiàn)它們的內(nèi)部邏輯相對(duì)清晰,繼而更易于維護(hù)。如下是一個(gè)使用上述封裝后庫(kù)的示例代碼:
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)
}
登錄后復(fù)制
在運(yùn)行這段代碼之前,需要先將庫(kù)文件放置到指定位置,并替換掉Import路徑中的username/repo_deliver_area,以及將地圖API的Access Token替換掉 YOUR_ACCESS_TOKEN。最終輸出將代表坐標(biāo)所在位置是否在服務(wù)范圍內(nèi)的布爾值。






