NAV Navbar
cURL

台灣圖霸 | Map8 Platform

歡迎使用 Logo 28x28 台灣圖霸 | Map8 Platform 地圖平台

有任何技術疑難,歡迎您發到 issues 專區~

或是有其他任何疑問,也都歡迎您 跟我們聯絡 喔!!!

Authentication (認證與授權)

要能取用 Map8 平台的 API,請於 URL query string 中以 key 參數帶入您的 API key :

https://api.map8.zone/place/geocode?address=台北市內湖區新湖三路189號&key=<您的 key>

請務必將上例 <您的 key> 替換成您的 API key 喔!!!

台灣圖霸平台 | Map8 Platform 的 API 透過 API key 來讓您使用平台的 API。您可以 點此申請試用

台灣圖霸平台 | Map8 Platform 的 API 預期來自 client 端的所有 API 請求於 URL 的 query string 中夾帶 API key 以認證並取得使用,例如 :

https://api.map8.zone/place/geocode?address=台北市內湖區新湖三路189號&key=<您的 key>

Notation

  1. 左右鍵符號 (大於、小於符號, 也就是 < >) 所描述的是一個變數 (variable) 的 formal parameter 形式。本文件底下若提及參數部分,使用到此表示法時,請讀者將之代換成實際的內容 (也就是代換為 actual parameter,並且,不留下 < > 符號)。例如, https://api.map8.zone/find?keyword=<關鍵詞> 若實際關鍵詞為 taiwan,則實際呼叫時,應代換為 https://api.map8.zone/find?keyword=taiwan
  2. 位於 API 欄位內格式的 <參數>,為標準的 URL 之 query string 格式編碼 (i.e., name=value 以 URL % 編碼, 並以 & 連接)
  3. 除非另有指定,否則,地理經緯度座標 (lat 或 latitude 均指經度,lng 或 longitude 均指緯度) 以 WGS84 / EPSG:3857 為地理座標系統

Version

API Index

Places > Places API SPEC

功能 : 搜尋台灣圖霸的地圖圖資

Place Search

Find Place API

Syntax

https://api.map8.zone/place/findplacefromtext/json?key=<您的 key>
    &input=<input>
    &locationbias=<緯度>,<經度>

Example

curl -X GET "https://api.map8.zone/place/findplacefromtext/json?key=<您的 key>&input=研鼎智能&locationbias=25.06102,121.58790"
{
    "html_attributions" : [
        "台灣圖霸", 
        "研鼎智能", 
        "PAPAGO!"
    ],
    "candidates" : [
      {
        "formatted_address" : "台北市內湖區新湖三路189號6樓",
        "geometry" : {
            "location" : {
                "lat" : 25.065089,
                "lng" : 121.580056
            },
        },
        "id" : "R625AYXZ38324999QP10236181",
        "place_id" : "R625AYXZ38324999QP10236181",
        "name" : "研鼎智能股份有限公司",
        "tel" : "02-87921567",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "", 
        "branch" : "",
        "cat" : "公司行號",
        "distance" : "0.3"
      }
    ],
    "status" : "OK"
}

給定關鍵字,搜尋地點

Nearby Search API

Syntax

https://api.map8.zone/place/findplacefromtext/json?key=<您的 key>
    &location=<緯度>,<經度>
    &radius=<範圍 (km)>

Example

curl -X GET "https://api.map8.zone/place/nearbysearch/json?key=<您的 key>&location=25.06102,121.58790"
{
    "html_attributions" : [
        "台灣圖霸", 
        "研鼎智能", 
        "PAPAGO!"
    ],
    "results" : [
      {
        "formatted_address" : "台北市內湖區南京東路六段465號",
        "geometry" : {
            "location" : {
                "lat" : 25.060955,
                "lng" : 121.587635
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "南京東路六段465號",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "地址",
        "chain" : "", 
        "branch" : "",
        "cat" : "",
        "distance" : 0.028
      },
      {
        "formatted_address" : "台北市內湖區南京東路六段463號",
        "geometry" : {
            "location" : {
                "lat" : 25.060904,
                "lng" : 121.587504
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "光屋攝影工作室",
        "tel" : "02-87919199",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "", 
        "branch" : "",
        "cat" : "購物商場",
        "distance" : 0.0419
      }, 
      {
        "formatted_address" : "台北市內湖區南京東路六段463號",
        "geometry" : {
            "location" : {
                "lat" : 25.060904,
                "lng" : 121.587504
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "南京東路六段463號",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "地址",
        "chain" : "", 
        "branch" : "",
        "cat" : "",
        "distance" : 0.0419
      },
      {
        "formatted_address" : "台北市內湖區南京東路六段487號",
        "geometry" : {
            "location" : {
                "lat" : 25.061352,
                "lng" : 121.588254
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "南京東路六段465號",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "地址",
        "chain" : "", 
        "branch" : "",
        "cat" : "",
        "distance" : 0.0513
      },
      {
        "formatted_address" : "南京東路六段489號",
        "geometry" : {
            "location" : {
                "lat" : 25.060955,
                "lng" : 121.587635
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "南京東路六段489號",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "地址",
        "chain" : "", 
        "branch" : "",
        "cat" : "",
        "distance" : 0.0534
      }, 
      {
        "formatted_address" : "台北市內湖區南京東路六段461號",
        "geometry" : {
            "location" : {
                "lat" : 25.060904,
                "lng" : 121.587504
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "108 CUSTOM",
        "tel" : "02-27908383",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "", 
        "branch" : "",
        "cat" : "租車公司",
        "distance" : 0.055
      }
    ],
    "status" : "OK"
}

給定座標,搜尋周遭

Text Search API

Syntax

https://api.map8.zone/place/textsearch/json?key=<您的 key>
    &query=<關鍵字 (可空白分隔)>
    &location=<緯度>,<經度>

Example : 搜尋 加油站 內湖 台北

curl -X GET "https://api.map8.zone/place/textsearch/json?key=<您的 key>&query=加油站 內湖 台北&location=25.06102,121.58790"
{
    "html_attributions" : [
        "台灣圖霸", 
        "研鼎智能", 
        "PAPAGO!"
    ],
    "results" : [
      {
        "formatted_address" : "台北市內湖區新明路92號",
        "geometry" : {
            "location" : {
                "lat" : 25.059615,
                "lng" : 121.589523
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "統一速邁樂加油站內湖一站",
        "tel" : "02-27929031",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "統一速邁樂加油站", 
        "branch" : "內湖一站",
        "cat" : "加油站",
        "distance" : 0.226
      },
      {
        "formatted_address" : "台北市內湖區南京東路六段463號",
        "geometry" : {
            "location" : {
                "lat" : 25.060904,
                "lng" : 121.587504
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "中油加油站協記站",
        "tel" : "02-27915409",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "中油加油站", 
        "branch" : "協記站",
        "cat" : "加油站",
        "distance" : 0.543
      }, 
      {
        "formatted_address" : "台北市內湖區新明路305號",
        "geometry" : {
            "location" : {
                "lat" : 25.05699,
                "lng" : 121.584842
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "台灣宅配通-中油加油站協記站-代收店",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "台灣宅配通", 
        "branch" : "中油加油站協記站-代收店",
        "cat" : "貨運站",
        "distance" : 0.0544
      },
      {
        "formatted_address" : "台北市南港區南港路三段49號",
        "geometry" : {
            "location" : {
                "lat" : 25.053272,
                "lng" : 121.590197
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "全國加油站南港站",
        "tel" : "02-27828306",
        "city" : "台北市", 
        "town" : "南港區", 
        "type" : "景點",
        "chain" : "全國加油站", 
        "branch" : "南港站",
        "cat" : "加油站",
        "distance" : 0.892
      },
      {
        "formatted_address" : "台北市內湖區民權東路六段50號",
        "geometry" : {
            "location" : {
                "lat" : 25.068355,
                "lng" : 121.583351
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "gogoro電池交換站中油內湖加油站",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "gogoro充電站", 
        "branch" : "中油內湖加油站",
        "cat" : "充電站",
        "distance" : 0.934
      }, 
      {
        "formatted_address" : "台北市內湖區民權東路六段50號",
        "geometry" : {
            "location" : {
                "lat" : 25.068355,
                "lng" : 121.583351
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "中油加油站內湖站",
        "tel" : "02-27920678",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "中油加油站", 
        "branch" : "內湖站",
        "cat" : "加油站",
        "distance" : 0.936
      }
    ],
    "status" : "OK"
}

以任意的關鍵字組合進行搜尋

Place Autocomplete API

Syntax

https://api.map8.zone/place/textsearch/json?key=<您的 key>
    &input=<關鍵字 (可空白分隔)>
    &location=<緯度>,<經度>
    &radius=<範圍 (km)>

Example

curl -X GET "https://api.map8.zone/place/autocomplete/json?key=<您的 key>&input=明美&location=25.06102,121.58790"
{
    "html_attributions" : [
        "台灣圖霸", 
        "研鼎智能", 
        "PAPAGO!"
    ],
    "results" : [
      {
        "formatted_address" : "台北市內湖區南京東路六段北側",
        "geometry" : {
            "location" : {
                "lat" : 25.060834,
                "lng" : 121.587175
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "明美公園",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "", 
        "branch" : "",
        "cat" : "公園",
        "distance" : 0.075, 
      }, 
      {
        "formatted_address" : "",
        "geometry" : {
            "location" : {
                "lat" : 25.028364,
                "lng" : 121.587175
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "YouBike微笑單車明美公園",
        "tel" : "",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "景點",
        "chain" : "YouBike微笑單車", 
        "branch" : "明美公園",
        "cat" : "租車公司",
        "distance" : 0.252, 
      },
      {
        "formatted_address" : "台北市松山區新東街28號之1",
        "geometry" : {
            "location" : {
                "lat" : 25.059238,
                "lng" : 121.566031
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "明美",
        "tel" : "02-27628939",
        "city" : "台北市", 
        "town" : "松山區", 
        "type" : "景點",
        "chain" : "", 
        "branch" : "",
        "cat" : "購物商場",
        "distance" : 2.21, 
      },
      {
        "formatted_address" : "台北市信義區松德路40號",
        "geometry" : {
            "location" : {
                "lat" : 25.038958,
                "lng" : 121.576684
            },
        },
        "id" : "R625AYXZ38324999QP10236182",
        "place_id" : "R625AYXZ38324999QP10236182",
        "name" : "明美精品名店",
        "tel" : "02-27584348",
        "city" : "台北市", 
        "town" : "信義區", 
        "type" : "景點",
        "chain" : "", 
        "branch" : "",
        "cat" : "購物商場",
        "distance" : 2.7, 
      }
    ],
    "status" : "OK"
}

依據給定的搜尋關鍵字,回應出推測的可能清單 (通常運用在需要極佳使用體驗, 逐字逼近搜尋目標物的場景上)

Places > Geocoding API SPEC

功能 : - 地址定位 (geocoding, 也就是將 地址 / 門牌 轉為地理座標 經緯度) - 與 - 反地址定位 (reverse geocoding, 反過來將地理座標 經緯度 轉為 地址 / 門牌)

Geocoding API

Syntax

https://api.map8.zone/place/textsearch/json?key=<您的 key>
    &address=<關鍵字 (可空白分隔)>
    &latlng=<緯度>,<經度>
    &postcode
    &formatted_address_embed_postcode
    &additional_fields

Example : 地址定位 (帶入 address 參數)

curl -X GET "https://api.map8.zone/place/geocode/json?key=<您的 key>&address=台北市內湖區新湖三路189號"
{
    "html_attributions" : [
        "台灣圖霸", 
        "研鼎智能", 
        "PAPAGO!"
    ],
    "results" : [
      {
        "formatted_address" : "台北市內湖區新湖三路189號6樓",
        "geometry" : {
            "location" : {
                "lat" : 25.065089,
                "lng" : 121.580056
            },
        },
        "id" : "R625AYXZ38324999QP10236181",
        "place_id" : "R625AYXZ38324999QP10236181",
        "name" : "新湖三路189號",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "地址",
      }
    ],
    "status" : "OK"
}

Example : 反地址定位 (帶入 latlng 參數)

curl -X GET "https://api.map8.zone/place/geocode/json?key=<您的 key>&latlng=25.065089,121.580056"
{
    "html_attributions" : [
        "台灣圖霸", 
        "研鼎智能", 
        "PAPAGO!"
    ],
    "results" : [
      {
        "formatted_address" : "台北市內湖區新湖三路189號6樓",
        "geometry" : {
            "location" : {
                "lat" : 25.065089,
                "lng" : 121.580056
            },
        },
        "id" : "R625AYXZ38324999QP10236181",
        "place_id" : "R625AYXZ38324999QP10236181",
        "name" : "新湖三路189號",
        "city" : "台北市", 
        "town" : "內湖區", 
        "type" : "地址",
      }
    ],
    "status" : "OK"
}

Maps Embed API SPEC

功能 : 在您的網站中嵌入互動地圖

Maps Embed API

Example (請於瀏覽器直接打開;或透過本文主說明示範之 iframe)

https://maps.map8.zone/?key=<您的 key>&title=研鼎智能&address=台北市內湖區新湖三路189號6樓&description=台灣圖霸,有口皆碑#15.6/25.065089/121.580056

Example : 加上 optional 的地圖視角 (請於瀏覽器直接打開;或透過本文主說明示範之 iframe)

https://maps.map8.zone/?key=<您的 key>&title=研鼎智能&address=台北市內湖區新湖三路189號6樓&description=台灣圖霸,有口皆碑#15.6/25.065089/121.580056/0/50

您也可以使用 iframe 方式來將台灣圖霸的地圖嵌入您的網站 -- 如下示範,只要將上述網址格式直接填入底下 <iframe> 標籤內的 src 欄位即可 :

<iframe src="https://maps.map8.zone/?key=<您的 key>&title=研鼎智能&address=台北市內湖區新湖三路189號6樓&description=台灣圖霸,有口皆碑#15.6/25.065089/121.580056/0/50" width="640" height="480"></iframe>

Maps embed api iframe example 7

讓您在網站或其他任何素材中嵌入互動地圖

Maps Static API SPEC

功能 : 在您的網站中嵌入靜態地圖 (圖片)

Maps Static API

Example (請於瀏覽器直接打開)

https://api.map8.zone/maps/static?key=<您的 key>&center=25.03745%2C121.547428&zoom=17&size=1024x768&format=jpg

Maps static api demo

製作顯示地圖的圖檔,讓您在網站或其他任何素材中嵌入靜態地圖

Routes > Directions API SPEC

功能 : 路徑規劃 API

Directions API

Syntax

https://api.map8.zone/routes/car/<起終點座標>json?key=<您的 key>

Example (請於瀏覽器直接打開)

curl -X GET "https://api.map8.zone/route/car/121.54682830627758,25.05780519838912;121.54760773136468,25.0576378974028.json?key=<您的 key>"
{
  "code": "Ok",
  "waypoints": [
    {
      "hint": "string",
      "name": "",
      "location": [
        [
          121.546828,
          25.057806
        ]
      ],
      "distance": 110.769
    }
  ],
  "routes": [
    {
      "legs": [
        {
          "distance": 0,
          "duration": 0,
          "summary": "string",
          "weight": 0,
          "steps": [
            {
              "driving_side": "string",
              "distance": 0,
              "geometry": "string",
              "duration": 0,
              "weight": 0,
              "name": "string",
              "mode": "string",
              "maneuver": [
                {
                  "bearing_after": 0,
                  "bearing_before": 0,
                  "type": "string",
                  "location": [
                    [
                      121.546828,
                      25.057806
                    ]
                  ]
                }
              ],
              "intersections": [
                {
                  "out": 0,
                  "entry": [
                    [
                      "true",
                      "true"
                    ]
                  ],
                  "location": [
                    [
                      121.546828,
                      25.057806
                    ]
                  ],
                  "bearings": [
                    [
                      121,
                      272
                    ]
                  ]
                }
              ]
            }
          ]
        }
      ],
      "weight_name": "string",
      "geometry": "string",
      "weight": 32,
      "distance": 228.4,
      "duration": 32.6
    }
  ]
}

路徑規劃功能 : 依據所給之起點跟終點兩個點的地理座標,依 Map8 的圖資與演算法來產生連接此兩點的路徑



https://map8.zone

HTTP Status Code

以上 API,可能回傳的 HTTP status code 如后 :

Error Code 意義
400 Bad Request -- 表示您的 requset 解析有誤。通常是給入的參數多了或少了,或是格式有錯誤,或必要參數卻沒給,等等
401 Unauthorized -- 表示您未給定您的 key,或是您給的 key 並非有效。請跟我們聯絡
503 Service Unavailable -- 表示您的 request 已經超出與我們約定的 QoS (服務品質) 等級。通常過一會兒 (QoS 上限解除) 再重發一次即可成功。如果持續發生,請跟我們聯絡

"status" 欄位

以上 API,可能回傳之 status 欄位的意義為 :

status 意義
OK 無發生任何錯誤;該地點被成功偵測,並且至少回傳一則結果
ZERO_RESULTS 表示搜尋雖然完成,但未得到任何有效結果。此狀況譬如可能發生在您對本 API 發出的 request 所給定的中心座標在一個偏遠地區
OVER_QUERY_LIMIT 表示您已經超出您的配額。請跟我們聯絡
REQUEST_DENIED 表示您的 request 無法進行;一般來說是您未給定您的 key,或是您給的 key 並非有效。請跟我們聯絡
INVALID_REQUEST 表示您的 requset 解析有誤。通常是給入的參數多了或少了,或是格式有錯誤,或必要參數卻沒給,等等
UNKNOWN_ERROR 表示是我們的伺服器端的錯誤;再重試一次可能就會成功。如果持續發生此問題,請跟我們聯絡