使用go-here库访问HERE位置服务API

go-here是一个Golang客户端库，用于访问HERE位置服务API。下面我将介绍如何使用这个库进行常见的位置服务操作。

安装

首先安装go-here库：

go get github.com/abdullahselek/go-here

基本使用

1. 初始化客户端

package main

import (
	"fmt"
	"github.com/abdullahselek/go-here/here"
)

func main() {
	// 使用你的HERE API凭证初始化
	credentials := here.Credentials{
		AppID:   "YOUR_APP_ID",
		AppCode: "YOUR_APP_CODE",
	}

	// 创建客户端
	client := here.New(credentials)
	
	// 或者使用API密钥(新版本HERE API使用)
	// client := here.NewWithAPIKey("YOUR_API_KEY")
}

2. 地理编码(地址转坐标)

func geocodeExample(client *here.Client) {
	// 设置地理编码参数
	geocodingParams := here.GeocodingParameters{
		SearchText: "200 S Mathilda Ave, Sunnyvale, CA",
	}

	// 执行地理编码请求
	response, err := client.Geocoding.Geocoding(&geocodingParams)
	if err != nil {
		fmt.Printf("Geocoding error: %v\n", err)
		return
	}

	// 处理响应
	if len(response.Response.View) > 0 && len(response.Response.View[0].Result) > 0 {
		location := response.Response.View[0].Result[0].Location.DisplayPosition
		fmt.Printf("Latitude: %f, Longitude: %f\n", location.Latitude, location.Longitude)
	}
}

3. 反向地理编码(坐标转地址)

func reverseGeocodeExample(client *here.Client) {
	// 设置反向地理编码参数
	params := here.ReverseGeocodingParameters{
		Latitude:  37.422,
		Longitude: -122.084,
		Mode:      here.ReverseGeocodingMode.RetrieveAddresses,
	}

	// 执行请求
	response, err := client.Geocoding.ReverseGeocoding(&params)
	if err != nil {
		fmt.Printf("Reverse geocoding error: %v\n", err)
		return
	}

	// 处理响应
	if len(response.Response.View) > 0 && len(response.Response.View[0].Result) > 0 {
		address := response.Response.View[0].Result[0].Location.Address
		fmt.Printf("Address: %s, %s, %s\n", address.Street, address.City, address.Country)
	}
}

4. 路线规划

func routingExample(client *here.Client) {
	// 设置路线参数
	params := here.RoutingParameters{
		Waypoint0: "geo!52.5,13.4",  // 起点
		Waypoint1: "geo!52.5,13.45", // 终点
		Mode:      here.RoutingMode.FastestCar,
	}

	// 获取路线
	response, err := client.Routing.Route(&params)
	if err != nil {
		fmt.Printf("Routing error: %v\n", err)
		return
	}

	// 处理响应
	if len(response.Response.Route) > 0 {
		route := response.Response.Route[0]
		fmt.Printf("Distance: %d meters\n", route.Summary.Distance)
		fmt.Printf("Travel Time: %d seconds\n", route.Summary.TravelTime)
		
		for _, maneuver := range route.Leg[0].Maneuver {
			fmt.Printf("Instruction: %s\n", maneuver.Instruction)
		}
	}
}

5. 兴趣点(POI)搜索

func placesExample(client *here.Client) {
	// 设置POI搜索参数
	params := here.PlacesParameters{
		In:       "37.7942,-122.4070", // 中心点坐标
		Distance: 1000,                // 搜索半径(米)
		Q:        "restaurant",        // 搜索关键词
	}

	// 执行搜索
	response, err := client.Places.Search(&params)
	if err != nil {
		fmt.Printf("Places search error: %v\n", err)
		return
	}

	// 处理响应
	for _, result := range response.Results.Items {
		fmt.Printf("Name: %s, Distance: %dm, Address: %s\n",
			result.Title,
			result.Distance,
			result.Vicinity)
	}
}

高级功能

批量请求

func batchExample(client *here.Client) {
	// 创建批量请求
	batch := client.Batch.NewBatchRequest()

	// 添加多个请求
	batch.AddGeocodingRequest(&here.GeocodingParameters{
		SearchText: "Berlin, Germany",
	})
	
	batch.AddReverseGeocodingRequest(&here.ReverseGeocodingParameters{
		Latitude:  52.5167,
		Longitude: 13.3833,
	})

	// 执行批量请求
	responses, err := batch.Execute()
	if err != nil {
		fmt.Printf("Batch error: %v\n", err)
		return
	}

	// 处理响应
	for _, response := range responses {
		switch r := response.(type) {
		case *here.GeocodingResponse:
			// 处理地理编码响应
		case *here.ReverseGeocodingResponse:
			// 处理反向地理编码响应
		}
	}
}

错误处理

func handleErrors(err error) {
	if hereErr, ok := err.(*here.Error); ok {
		fmt.Printf("HERE API Error: %s (Code: %d)\n", hereErr.Message, hereErr.Code)
	} else {
		fmt.Printf("Error: %v\n", err)
	}
}

总结

go-here库提供了访问HERE位置服务API的便捷方式。通过这个库，你可以轻松实现：

1. 地址与坐标之间的转换
2. 路线规划和导航
3. 兴趣点搜索
4. 批量处理多个请求

记得在使用前获取有效的HERE开发者凭证，并根据你的具体需求调整API参数。