以下示例代码适用于 www.apishop.net 网站下的API，使用本文提及的接口调用代码示例前，您需要先申请相应的API服务。
- 中国省市区查询：2017最新中国省市区地址
- 经纬度地址转换：经纬度地址相互转换
- POI检索：通过关键词查询在某个地区的POI信息，支持市级、区县级查询：比如在广州查询“银行”，接口将会输出所有银行的地理信息列表。
- 公交、地铁路线规划：公交、驾车、骑行、步行查询，返回json格式的检索数据。
**API Shop（apishop.net）提供多达50款的常用第三方API，可以从github上下载代码示例合集：https://github.com/apishop/All-APIs**
以上接口均包含PHP、Python、C#和Java等四种语言的代码示例，以 路线查询 API为例：
（1）基于PHP的 路线查询 API服务请求的代码示例
<?php
$method = "POST";
$url = "https://api.apishop.net/common/direction/queryRoutes";
$headers = NULL;
$params = array(
"origin" => "", //起点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
"destination" => "", //终点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
"mode" => "", //导航模式，包括：driving（驾车）、walking（步行）、transit（公交）、riding（骑行）,默认为transit
"region" => "", //所在城市，公交、步行导航时该参数必填。
"origin_region" => "", //起始点所在城市，驾车导航时必填。
"destination_region" => "", //终点所在城市，驾车导航时必填。
"coord_type" => "", //坐标类型，默认为bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度摩卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。
"ret_coordtype" => "", //可选，默认为百度经纬度坐标：bd09ll 可选值： bd09ll：百度经纬度坐标 gcj02：国测局坐标
"waypoints" => "", //途经点集合，包括一个或多个用竖线字符"|"分隔的地址名称或经纬度。支持驾车、步行方案，最多支持5个途经点。
"tactics" => "", //导航策略,默认为12。可选值， 10：不走高速； 11：常规路线，即多数人常走的一条路线，不受路况影响，可用于用车估价； 12：距离较短，即距离相对较短的一条路线，但并不一定是一条优质路线； 13：躲避拥堵
);
$result = apishop_curl($method, $url, $headers, $params);
If ($result) {
$body = json_decode($result["body"], TRUE);
$status_code = $body["statusCode"];
If ($status_code == "000000") {
//状态码为000000, 说明请求成功
echo "请求成功：" . $result["body"];
} else {
//状态码非000000, 说明请求失败
echo "请求失败：" . $result["body"];
}
} else {
//返回内容异常，发送请求失败，以下可根据业务逻辑自行修改
echo "发送请求失败";
}
/**
* 转发请求到目的主机
* @param $method string 请求方法
* @param $URL string 请求地址
* @param null $headers 请求头
* @param null $param 请求参数
* @return array|bool
*/
function apishop_curl(&$method, &$URL, &$headers = NULL, &$param = NULL)
{
// 初始化请求
$require = curl_init($URL);
// 判断是否HTTPS
$isHttps = substr($URL, 0, 8) == "https://" ? TRUE : FALSE;
// 设置请求方式
switch ($method) {
case "GET":
curl_setopt($require, CURLOPT_CUSTOMREQUEST, "GET");
break;
case "POST":
curl_setopt($require, CURLOPT_CUSTOMREQUEST, "POST");
break;
default:
return FALSE;
}
if ($param) {
curl_setopt($require, CURLOPT_POSTFIELDS, $param);
}
if ($isHttps) {
// 跳过证书检查
curl_setopt($require, CURLOPT_SSL_VERIFYPEER, FALSE);
// 检查证书中是否设置域名
curl_setopt($require, CURLOPT_SSL_VERIFYHOST, 2);
}
if ($headers) {
// 设置请求头
curl_setopt($require, CURLOPT_HTTPHEADER, $headers);
}
// 返回结果不直接输出
curl_setopt($require, CURLOPT_RETURNTRANSFER, TRUE);
// 重定向
curl_setopt($require, CURLOPT_FOLLOWLOCATION, TRUE);
// 把返回头包含再输出中
curl_setopt($require, CURLOPT_HEADER, TRUE);
// 发送请求
$response = curl_exec($require);
// 获取头部长度
$headerSize = curl_getinfo($require, CURLINFO_HEADER_SIZE);
// 关闭请求
curl_close($require);
if ($response) {
// 返回头部字符串
$header = substr($response, 0, $headerSize);
// 返回体
$body = substr($response, $headerSize);
// 过滤隐藏非法字符
$bodyTemp = json_encode(array(
0 => $body
));
$bodyTemp = str_replace("\ufeff", "", $bodyTemp);
$bodyTemp = json_decode($bodyTemp, TRUE);
$body = trim($bodyTemp[0]);
// 将返回结果头部转成数组
$respondHeaders = array();
$header_rows = array_filter(explode(PHP_EOL, $header), "trim");
foreach ($header_rows as $row) {
$keylen = strpos($row, ":");
if ($keylen) {
$respondHeaders[] = array(
"key" => substr($row, 0, $keylen),
"value" => trim(substr($row, $keylen + 1))
);
}
}
return array(
"headers" => $respondHeaders,
"body" => $body
);
} else {
return FALSE;
}
}（2）基于Python的 路线查询 API服务请求的代码示例
#!/usr/bin/env python
# -*- coding: utf-8 -*-
# 测试环境: python2.7
# 安装requests依赖 => pip install requests/ easy_install requests
# 导入requests依赖
import requests
import json
import sys
reload(sys)
sys.setdefaultencoding('utf-8')
def apishop_send_request(method, url, params=None, headers=None):
'''
转发请求到目的主机
@param method str 请求方法
@param url str 请求地址
@param params dict 请求参数
@param headers dict 请求头
'''
method = str.upper(method)
if method == 'POST':
return requests.post(url=url, data=params, headers=headers)
elif method == 'GET':
return requests.get(url=url, params=params, headers=headers)
else:
return None
method = "POST"
url = "https://api.apishop.net/common/direction/queryRoutes"
headers = None
params = {
"origin":"", #起点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
"destination":"", #终点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
"mode":"", #导航模式，包括：driving（驾车）、walking（步行）、transit（公交）、riding（骑行）,默认为transit
"region":"", #所在城市，公交、步行导航时该参数必填。
"origin_region":"", #起始点所在城市，驾车导航时必填。
"destination_region":"", #终点所在城市，驾车导航时必填。
"coord_type":"", #坐标类型，默认为bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度摩卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。
"ret_coordtype":"", #可选，默认为百度经纬度坐标：bd09ll 可选值： bd09ll：百度经纬度坐标 gcj02：国测局坐标
"waypoints":"", #途经点集合，包括一个或多个用竖线字符"|"分隔的地址名称或经纬度。支持驾车、步行方案，最多支持5个途经点。
"tactics":"", #导航策略,默认为12。可选值， 10：不走高速； 11：常规路线，即多数人常走的一条路线，不受路况影响，可用于用车估价； 12：距离较短，即距离相对较短的一条路线，但并不一定是一条优质路线； 13：躲避拥堵
}
result = apishop_send_request(method=method, url=url, params=params, headers=headers)
if result:
body = result.text
response = json.loads(body)
status_code = response["statusCode"]
if (status_code == '000000'):
# 状态码为000000, 说明请求成功
print('请求成功：%s' % (body,))
else:
# 状态码非000000, 说明请求失败
print('请求失败: %s' % (body,))
else:
# 返回内容异常，发送请求失败
print('发送请求失败')（3）基于C#的 路线查询 API服务请求的代码示例
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Text;
using System.Web.Script.Serialization;
namespace apishop_sdk
{
class Program
{
/**
* 转发请求到目的主机
* @param method string 请求方法
* @param url string 请求地址
* @param params Dictionary<string,string> 请求参数
* @param headers Dictionary<string,string> 请求头
* @return string
**/
static string apishop_send_request(string method, string url, Dictionary<string, string> param, Dictionary<string, string> headers)
{
string result = string.Empty;
try
{
string paramData = "";
if (param != null && param.Count > 0)
{
StringBuilder sbuilder = new StringBuilder();
foreach (var item in param)
{
if (sbuilder.Length > 0)
{
sbuilder.Append("&");
}
sbuilder.Append(item.Key + "=" + item.Value);
}
paramData = sbuilder.ToString();
}
method = method.ToUpper();
if (method == "GET")
{
url = string.Format("{0}?{1}", url, paramData);
}
HttpWebRequest wbRequest = (HttpWebRequest)WebRequest.Create(url);
if (method == "GET")
{
wbRequest.Method = "GET";
}
else if (method == "POST")
{
wbRequest.Method = "POST";
wbRequest.ContentType = "application/x-www-form-urlencoded";
wbRequest.ContentLength = Encoding.UTF8.GetByteCount(paramData);
using (Stream requestStream = wbRequest.GetRequestStream())
{
using (StreamWriter swrite = new StreamWriter(requestStream))
{
swrite.Write(paramData);
}
}
}
HttpWebResponse wbResponse = (HttpWebResponse)wbRequest.GetResponse();
using (Stream responseStream = wbResponse.GetResponseStream())
{
using (StreamReader sread = new StreamReader(responseStream))
{
result = sread.ReadToEnd();
}
}
}
catch
{
return "";
}
return result;
}
class Response
{
public string statusCode;
}
static void Main(string[] args)
{
string method = "POST";
string url = "https://api.apishop.net/common/direction/queryRoutes";
Dictionary<string, string> param = new Dictionary<string, string>();
param.Add("origin", ""); //起点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
param.Add("destination", ""); //终点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
param.Add("mode", ""); //导航模式，包括：driving（驾车）、walking（步行）、transit（公交）、riding（骑行）,默认为transit
param.Add("region", ""); //所在城市，公交、步行导航时该参数必填。
param.Add("origin_region", ""); //起始点所在城市，驾车导航时必填。
param.Add("destination_region", ""); //终点所在城市，驾车导航时必填。
param.Add("coord_type", ""); //坐标类型，默认为bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度摩卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。
param.Add("ret_coordtype", ""); //可选，默认为百度经纬度坐标：bd09ll 可选值： bd09ll：百度经纬度坐标 gcj02：国测局坐标
param.Add("waypoints", ""); //途经点集合，包括一个或多个用竖线字符"|"分隔的地址名称或经纬度。支持驾车、步行方案，最多支持5个途经点。
param.Add("tactics", ""); //导航策略,默认为12。可选值， 10：不走高速； 11：常规路线，即多数人常走的一条路线，不受路况影响，可用于用车估价； 12：距离较短，即距离相对较短的一条路线，但并不一定是一条优质路线； 13：躲避拥堵
Dictionary<string, string> headers = null;
string result = apishop_send_request(method, url, param, headers);
if (result == "")
{
//返回内容异常，发送请求失败
Console.WriteLine("发送请求失败");
return;
}
Response res = new JavaScriptSerializer().Deserialize<Response>(result);
if (res.statusCode == "000000")
{
//状态码为000000, 说明请求成功
Console.WriteLine(string.Format("请求成功: {0}", result));
}
else
{
//状态码非000000, 说明请求失败
Console.WriteLine(string.Format("请求失败: {0}", result));
}
Console.ReadLine();
}
}
}（4）基于Java的 路线查询 API服务请求的代码示例
package net.apishop.www.controller;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;
import com.alibaba.fastjson.JSONObject;
/**
* httpUrlConnection访问远程接口工具
*/
public class Api
{
/**
* 方法体说明：向远程接口发起请求，返回字节流类型结果
* param url 接口地址
* param requestMethod 请求方式
* param params 传递参数 重点：参数值需要用Base64进行转码
* return InputStream 返回结果
*/
public static InputStream httpRequestToStream(String url, String requestMethod, Map<String, String> params){
InputStream is = null;
try{
String parameters = "";
boolean hasParams = false;
// 将参数集合拼接成特定格式，如name=zhangsan&age=24
for (String key : params.keySet()){
String value = URLEncoder.encode(params.get(key), "UTF-8");
parameters += key + "=" + value + "&";
hasParams = true;
}
if (hasParams){
parameters = parameters.substring(0, parameters.length() - 1);
}
// 请求方式是否为get
boolean isGet = "get".equalsIgnoreCase(requestMethod);
// 请求方式是否为post
boolean isPost = "post".equalsIgnoreCase(requestMethod);
if (isGet){
url += "?" + parameters;
}
URL u = new URL(url);
HttpURLConnection conn = (HttpURLConnection) u.openConnection();
// 请求的参数类型(使用restlet框架时，为了兼容框架，必须设置Content-Type为“”空)
conn.setRequestProperty("Content-Type", "application/octet-stream");
//conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
// 设置连接超时时间
conn.setConnectTimeout(50000);
// 设置读取返回内容超时时间
conn.setReadTimeout(50000);
// 设置向HttpURLConnection对象中输出，因为post方式将请求参数放在http正文内，因此需要设置为ture，默认false
if (isPost){
conn.setDoOutput(true);
}
// 设置从HttpURLConnection对象读入，默认为true
conn.setDoInput(true);
// 设置是否使用缓存，post方式不能使用缓存
if (isPost){
conn.setUseCaches(false);
}
// 设置请求方式，默认为GET
conn.setRequestMethod(requestMethod);
// post方式需要将传递的参数输出到conn对象中
if (isPost){
DataOutputStream dos = new DataOutputStream(conn.getOutputStream());
dos.writeBytes(parameters);
dos.flush();
dos.close();
}
// 从HttpURLConnection对象中读取响应的消息
// 执行该语句时才正式发起请求
is = conn.getInputStream();
}catch(UnsupportedEncodingException e){
e.printStackTrace();
}catch(MalformedURLException e){
e.printStackTrace();
}catch(IOException e){
e.printStackTrace();
}
return is;
}
public static void main(String args[]){
String url = "https://api.apishop.net/common/direction/queryRoutes";
String requestMethod = "POST";
Map<String, String> params = new HashMap<String, String>();
params.put("origin", ""); //起点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
params.put("destination", ""); //终点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。若为步行路径规划，则起终点间直线距离不应超过200公里。如“广州塔”、“广州塔|23.114155,113.318977”
params.put("mode", ""); //导航模式，包括：driving（驾车）、walking（步行）、transit（公交）、riding（骑行）,默认为transit
params.put("region", ""); //所在城市，公交、步行导航时该参数必填。
params.put("origin_region", ""); //起始点所在城市，驾车导航时必填。
params.put("destination_region", ""); //终点所在城市，驾车导航时必填。
params.put("coord_type", ""); //坐标类型，默认为bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度摩卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。
params.put("ret_coordtype", ""); //可选，默认为百度经纬度坐标：bd09ll 可选值： bd09ll：百度经纬度坐标 gcj02：国测局坐标
params.put("waypoints", ""); //途经点集合，包括一个或多个用竖线字符"|"分隔的地址名称或经纬度。支持驾车、步行方案，最多支持5个途经点。
params.put("tactics", ""); //导航策略,默认为12。可选值， 10：不走高速； 11：常规路线，即多数人常走的一条路线，不受路况影响，可用于用车估价； 12：距离较短，即距离相对较短的一条路线，但并不一定是一条优质路线； 13：躲避拥堵
String result = null;
try{
InputStream is = httpRequestToStream(url, requestMethod, params);
byte[] b = new byte[is.available()];
is.read(b);
result = new String(b);
}catch(IOException e){
e.printStackTrace();
}
if (result != null){
JSONObject jsonObject = JSONObject.parseObject(result);
String status_code = jsonObject.getString("statusCode");
if (status_code == "000000"){
// 状态码为000000, 说明请求成功
System.out.println("请求成功：" + jsonObject.getString("result"));
}else{
// 状态码非000000, 说明请求失败
System.out.println("请求失败：" + jsonObject.getString("desc"));
}
}else{
// 返回内容异常，发送请求失败，以下可根据业务逻辑自行修改
System.out.println("发送请求失败");
}
}
}