NAV Navbar
範例

台灣圖霸 | Map8 Platform

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

有任何技術疑難，或其他疑問，都歡迎您 跟我們聯絡 喔!!!

Authentication (認證與授權)

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

https://api.map8.zone/v2/place/geocode?address=台北市內湖區港墘路200號&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/v2/place/geocode?address=台北市內湖區港墘路200號&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:4326 為地理座標系統

Version

API Index

[Places] 地點搜尋

功能 : 搜尋台灣圖霸地圖內的地點

搜尋地點 API (Find Place API)

Syntax 

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

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example

HTTP GET "https://api.map8.zone/v2/place/findplacefromtext/json?key=<您的 key>&input=研鼎智能&locationbias=25.06102,121.58790"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "result": {
    "formatted_address": "台北市內湖區港墘路200號4樓之3",
    "geometry": {
      "location": {
        "lat": 25.075904,
        "lng": 121.574494
      }
    },
    "id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "place_id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "name": "研鼎智能股份有限公司",
    "tel": "02-87921567",
    "city": "台北市",
    "town": "內湖區",
    "type": "地點",
    "chain": "",
    "branch": "",
    "cat": "公司行號",
    "distance": 0.91
  },
  "status": "OK"
}

Example : 搜尋地點，並要求若搜尋結果有地址則附帶三碼郵遞區號

HTTP GET "https://api.map8.zone/v2/place/findplacefromtext/json?key=<您的 key>&input=研鼎智能&locationbias=25.06102,121.58790&postcode"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "result": {
    "formatted_address": "台北市內湖區港墘路200號4樓之3",
    "geometry": {
      "location": {
        "lat": 25.075904,
        "lng": 121.574494
      }
    },
    "id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "place_id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "name": "研鼎智能股份有限公司",
    "tel": "02-87921567",
    "city": "台北市",
    "town": "內湖區",
    "type": "地點",
    "chain": "",
    "branch": "",
    "cat": "公司行號",
    "distance": 0.91,
    "postcode": "114"
  },
  "status": "OK"
}

Example : 搜尋地點，並要求若搜尋結果有地址則附帶三碼郵遞區號內嵌於 formatted_address 欄位

HTTP GET "https://api.map8.zone/v2/place/findplacefromtext/json?key=<您的 key>&input=研鼎智能&locationbias=25.06102,121.58790&postcode&formatted_address_embed_postcode"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "result": {
    "formatted_address": "114 台北市內湖區港墘路200號4樓之3",
    "geometry": {
      "location": {
        "lat": 25.075904,
        "lng": 121.574494
      }
    },
    "id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "place_id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "name": "研鼎智能股份有限公司",
    "tel": "02-87921567",
    "city": "台北市",
    "town": "內湖區",
    "type": "地點",
    "chain": "",
    "branch": "",
    "cat": "公司行號",
    "distance": 0.91
  },
  "status": "OK"
}

給定關鍵詞，搜尋地點

地點詳細資訊 API (Place Details API)

Syntax 

https://api.map8.zone/v2/place/details/json?key=<您的 key>
    &placeid=<地點 id>
    &postcode=true
    &formatted_address_embed_postcode=true

Example : 給定地點 ID 以取得地點詳細資訊 (同時，若該地點有地址，也取回三碼郵遞區號)

HTTP GET "https://api.map8.zone/v2/place/details/json?key=<您的 key>&placeid=NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg%3D%3D&postcode=true"

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

因此，上開範例的 `placeid` 參數之值 : 
NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg%3D%3D
乃是將原始數值 : 
NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==
透過 URL encode 後所獲得。

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "result": {
    "formatted_address": "台北市內湖區港墘路200號4樓之3",
    "geometry": {
      "location": {
        "lat": 25.075904,
        "lng": 121.574494
      }
    },
    "id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "place_id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
    "name": "研鼎智能股份有限公司",
    "tel": "02-87921567",
    "city": "台北市",
    "town": "內湖區",
    "type": "地點",
    "chain": "",
    "branch": "",
    "cat": "公司行號",
    "distance": 0,
    "postcode": "114"
  },
  "status": "OK"
}

取得地點詳細資訊 (主要用於Autocomplete API -- 當使用者選擇了候選清單中的一項的時候，透過 place_id 呼叫本 API 以取得座標、電話等等詳細資料)。

搜尋周遭 API (Nearby Search API)

Syntax 

https://api.map8.zone/v2/place/nearbysearch/json?key=<您的 key>
    &location=<緯度>,<經度>
    &radius=<範圍 (km)>
    &cat=<以逗號分隔所列舉之地點類型>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example : 搜尋以地點為中心之周遭的便利商店與學校 (註 : 為減少篇幅，底下僅列出前五筆)

HTTP GET "https://api.map8.zone/v2/place/nearbysearch/json?key=<您的 key>&location=25.075904,121.574494&cat=便利商店,國小,國中,高中職校&postcode=true"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "results": [
          {
            "formatted_address": "台北市內湖區瑞光路302號1樓",
            "geometry": {
                "location": {
                    "lat": 25.076494,
                    "lng": 121.574273
                }
            },
            "id": "NzYqAQYFRB4KVl9TMF5nJQgoNB1PUiNaGjIFRgpiDBZISQMHA2AGEg==",
            "place_id": "NzYqAQYFRB4KVl9TMF5nJQgoNB1PUiNaGjIFRgpiDBZISQMHA2AGEg==",
            "name": "全家便利商店瑞亞店",
            "tel": "02-77287636",
            "city": "台北市",
            "town": "內湖區",
            "type": "地點",
            "chain": "全家便利商店",
            "branch": "瑞亞店",
            "cat": "便利商店",
            "distance": 0.069,
            "postcode": "114"
        },
        {
            "formatted_address": "台北市內湖區江南街128號",
            "geometry": {
                "location": {
                    "lat": 25.076234,
                    "lng": 121.575543
                }
            },
            "id": "NzYqAQYCRhwDX1NTNh5+KTJOMwByZxxxDzpdewlEFiFWLTsHbF4CEg==",
            "place_id": "NzYqAQYCRhwDX1NTNh5+KTJOMwByZxxxDzpdewlEFiFWLTsHbF4CEg==",
            "name": "7-ELEVEN瑞湖門市",
            "tel": "02-26588016",
            "city": "台北市",
            "town": "內湖區",
            "type": "地點",
            "chain": "7-ELEVEN",
            "branch": "瑞湖門市",
            "cat": "便利商店",
            "distance": 0.112,
            "postcode": "114"
        },
        {
            "formatted_address": "台北市內湖區瑞光路316巷56號",
            "geometry": {
                "location": {
                    "lat": 25.075855,
                    "lng": 121.573201
                }
            },
            "id": "NzYqAQYAQRkKXV9TWCgBEDVJHS0BBVpeGAVydAxBMSgSFDxUWWgeEg==",
            "place_id": "NzYqAQYAQRkKXV9TWCgBEDVJHS0BBVpeGAVydAxBMSgSFDxUWWgeEg==",
            "name": "7-ELEVEN瑞和門市",
            "tel": "02-26584041",
            "city": "台北市",
            "town": "內湖區",
            "type": "地點",
            "chain": "7-ELEVEN",
            "branch": "瑞和門市",
            "cat": "便利商店",
            "distance": 0.13,
            "postcode": "114"
        },
        {
            "formatted_address": "台北市內湖區瑞光路303號",
            "geometry": {
                "location": {
                    "lat": 25.075916,
                    "lng": 121.575896
                }
            },
            "id": "NzYqAQYERx0GXVtTDxp+ViUxMgB8WR5GAy5vYklkAw8kTjNRDmYWEg==",
            "place_id": "NzYqAQYERx0GXVtTDxp+ViUxMgB8WR5GAy5vYklkAw8kTjNRDmYWEg==",
            "name": "全家便利商店瑞興店",
            "tel": "02-77093306",
            "city": "台北市",
            "town": "內湖區",
            "type": "地點",
            "chain": "全家便利商店",
            "branch": "瑞興店",
            "cat": "便利商店",
            "distance": 0.141,
            "postcode": "114"
        },
        {
            "formatted_address": "台北市內湖區瑞光路220號",
            "geometry": {
                "location": {
                    "lat": 25.075529,
                    "lng": 121.576073
                }
            },
            "id": "NzYqAQYEQhoFVlpTRTwOClYYFBl3WStpXBNnB05SDlYFEjBDT10aEg==",
            "place_id": "NzYqAQYEQhoFVlpTRTwOClYYFBl3WStpXBNnB05SDlYFEjBDT10aEg==",
            "name": "全家便利商店瑞豐店",
            "tel": "02-77301103",
            "city": "台北市",
            "town": "內湖區",
            "type": "地點",
            "chain": "全家便利商店",
            "branch": "瑞豐店",
            "cat": "便利商店",
            "distance": 0.164,
            "postcode": "114"
        },
  ],
  "status": "OK"
}

Example : 不指定 cat (地點類型) 參數 (註 : 為減少篇幅，底下僅列出前五筆)

HTTP GET "https://api.map8.zone/v2/place/nearbysearch/json?key=<您的 key>&location=25.06102,121.58790"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "results": [
       {
        "formatted_address": "台北市內湖區港墘路200號",
        "geometry": {
            "location": {
                "lat": 25.075904,
                "lng": 121.574494
            }
        },
        "id": "NzYqAQYHTB0FWFhTHQZ+TBEoFhV7Qg9iOi1fYQ1FDy9VKTRmQwEeEg==",
        "place_id": "NzYqAQYHTB0FWFhTHQZ+TBEoFhV7Qg9iOi1fYQ1FDy9VKTRmQwEeEg==",
        "name": "景睿科技股份有限公司",
        "tel": "02-26562508",
        "city": "台北市",
        "town": "內湖區",
        "type": "地點",
        "chain": "",
        "branch": "",
        "cat": "公司行號",
        "distance": 0
    },
    {
        "formatted_address": "台北市內湖區港墘路200號4樓之3",
        "geometry": {
            "location": {
                "lat": 25.075904,
                "lng": 121.574494
            }
        },
        "id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
        "place_id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
        "name": "研鼎智能股份有限公司",
        "tel": "02-87921567",
        "city": "台北市",
        "town": "內湖區",
        "type": "地點",
        "chain": "",
        "branch": "",
        "cat": "公司行號",
        "distance": 0
    },
    {
        "formatted_address": "台北市內湖區港墘路200號4樓",
        "geometry": {
            "location": {
                "lat": 25.075904,
                "lng": 121.574494
            }
        },
        "id": "NzYqAQYCRh4EW19THlt1Uys9NR5eQQNTQg8EWHRZEUlfNQFyWURBEg==",
        "place_id": "NzYqAQYCRh4EW19THlt1Uys9NR5eQQNTQg8EWHRZEUlfNQFyWURBEg==",
        "name": "研勤科技股份有限公司(PAPAGO)",
        "tel": "02-87510123",
        "city": "台北市",
        "town": "內湖區",
        "type": "地點",
        "chain": "",
        "branch": "",
        "cat": "公司行號",
        "distance": 0
    },
    {
        "formatted_address": "台北市內湖區港墘路200號",
        "geometry": {
            "location": {
                "lat": 25.075904,
                "lng": 121.574494
            }
        },
        "id": "NzYqAQYBRx8AXl9TExlFXhMYMk51dFxXXB0HYXRNET8CHQ1fXkZBEg==",
        "place_id": "NzYqAQYBRx8AXl9TExlFXhMYMk51dFxXXB0HYXRNET8CHQ1fXkZBEg==",
        "name": "SKODA汽車台北內湖新車展示中心",
        "tel": "02-27985758",
        "city": "台北市",
        "town": "內湖區",
        "type": "地點",
        "chain": "SKODA汽車",
        "branch": "台北內湖新車展示中心",
        "cat": "汽車展售",
        "distance": 0
    },
    {
        "formatted_address": "台北市內湖區港墘路200號",
        "geometry": {
            "location": {
                "lat": 25.075904,
                "lng": 121.574494
            }
        },
        "id": "NzYqAQYBQhkAWl1TGxldSFQTMy98XQ5INSJ8fgBFKzskCzZ3BWM8Eg==",
        "place_id": "NzYqAQYBQhkAWl1TGxldSFQTMy98XQ5INSJ8fgBFKzskCzZ3BWM8Eg==",
        "name": "大中新記貿易股份有限公司",
        "tel": "02-87972277",
        "city": "台北市",
        "town": "內湖區",
        "type": "地點",
        "chain": "",
        "branch": "",
        "cat": "公司行號",
        "distance": 0
    },
  ],
  "status": "OK"
}

給定座標，搜尋周遭

任意關鍵詞搜尋 API (Text Search API)

Syntax 

https://api.map8.zone/v2/place/textsearch/json?key=<您的 key>
    &query=<關鍵詞 (可空白分隔)>
    &location=<緯度>,<經度>
    &cat=<以逗號分隔所列舉之地點類型>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example : 以 內湖 台北 為關鍵字搜尋 地點類型 為 加油站 者 (註 : 為減少篇幅，底下僅列出前五筆)

HTTP GET "https://api.map8.zone/v2/place/textsearch/json?key=<您的 key>&query=內湖 台北&cat=加油站&location=25.06102,121.58790"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "results": [
    {
      "formatted_address": "台北市內湖區新明路92號",
      "geometry": {
        "location": {
          "lat": 25.059615,
          "lng": 121.589523
        }
      },
      "id": "NzYqAQYCRh0BXVNTPQV9CxcoDzIMcwtXHzkGU3dYEQ8TDRF8WhlBEg==",
      "place_id": "NzYqAQYCRh0BXVNTPQV9CxcoDzIMcwtXHzkGU3dYEQ8TDRF8WhlBEg==",
      "name": "統一速邁樂加油站內湖一站",
      "tel": "02-27929031",
      "city": "台北市",
      "town": "內湖區",
      "type": "地點",
      "chain": "統一速邁樂加油站",
      "branch": "內湖一站",
      "cat": "加油站",
      "distance": 0.226
    },
    {
      "formatted_address": "台北市內湖區民權東路六段50號",
      "geometry": {
        "location": {
          "lat": 25.068355,
          "lng": 121.583351
        }
      },
      "id": "NzYqAQYHTR4BWVxTQydkJC4fTAF6ZlgDNAR4QVkfADQyFUJ3U0RNEg==",
      "place_id": "NzYqAQYHTR4BWVxTQydkJC4fTAF6ZlgDNAR4QVkfADQyFUJ3U0RNEg==",
      "name": "台灣宅配通-中油加油站內湖站-代收店",
      "tel": "02-27920678",
      "city": "台北市",
      "town": "內湖區",
      "type": "地點",
      "chain": "台灣宅配通",
      "branch": "中油加油站內湖站-代收店",
      "cat": "貨運站",
      "distance": 0.936
    },
    {
      "formatted_address": "台北市內湖區民權東路六段50號",
      "geometry": {
        "location": {
          "lat": 25.068355,
          "lng": 121.583351
        }
      },
      "id": "NzYqAQYCRh0BXV9TMSMOEx0+STRRfQ9oWFNcawFEMSALDyMGdFkWEg==",
      "place_id": "NzYqAQYCRh0BXV9TMSMOEx0+STRRfQ9oWFNcawFEMSALDyMGdFkWEg==",
      "name": "中油加油站內湖站",
      "tel": "02-27920678",
      "city": "台北市",
      "town": "內湖區",
      "type": "地點",
      "chain": "中油加油站",
      "branch": "內湖站",
      "cat": "加油站",
      "distance": 0.936
    },
    {
      "formatted_address": "台北市內湖區內湖路一段362號",
      "geometry": {
        "location": {
          "lat": 25.081308,
          "lng": 121.571103
        }
      },
      "id": "NzYqAQYHTR8CXlxTWD0AFQUUUiFuTD8FTw1vYk98KQM2ABR8QxkaEg==",
      "place_id": "NzYqAQYHTR8CXlxTWD0AFQUUUiFuTD8FTw1vYk98KQM2ABR8QxkaEg==",
      "name": "台灣宅配通-中油加油站內湖麗山街站-代收店",
      "tel": "02-26577339",
      "city": "台北市",
      "town": "內湖區",
      "type": "地點",
      "chain": "台灣宅配通",
      "branch": "中油加油站內湖麗山街站-代收店",
      "cat": "貨運站",
      "distance": 2.82
    },
    {
      "formatted_address": "台北市內湖區內湖路一段362號",
      "geometry": {
        "location": {
          "lat": 25.081308,
          "lng": 121.571103
        }
      },
      "id": "NzYqAQYCRh0AXlpTMCJSJTE/OFhQc1xVBQB/dnYMLj4IMgBfAFkgEg==",
      "place_id": "NzYqAQYCRh0AXlpTMCJSJTE/OFhQc1xVBQB/dnYMLj4IMgBfAFkgEg==",
      "name": "中油加油站內湖麗山街站",
      "tel": "02-26577339",
      "city": "台北市",
      "town": "內湖區",
      "type": "地點",
      "chain": "中油加油站",
      "branch": "內湖麗山街站",
      "cat": "加油站",
      "distance": 2.82
    }
  ],
  "status": "OK"
}

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

地點自動完成 API (Place Autocomplete API)

Syntax 

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

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example

HTTP GET "https://api.map8.zone/v2/place/autocomplete/json?key=<您的 key>&input=明美&location=25.06102,121.58790"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "status": "OK",
  "predictions": [
    {
      "id": "NzYqAQYGQhoHWlpTOi0OLlIbDkdAZR0DAA5+UAtYCxwgNhxdRVggEg==",
      "place_id": "NzYqAQYGQhoHWlpTOi0OLlIbDkdAZR0DAA5+UAtYCxwgNhxdRVggEg==",
      "name": "明美",
      "city": "台北市",
      "town": "松山區",
      "type": "地點",
      "cat": "購物商場",
      "distance": 2.212
    },
    {
      "id": "NzYqAQYEQR8LWVtTQDwZFgkVPTZVekVeMy5VQUkfXiggTCRbDngkEg==",
      "place_id": "NzYqAQYEQR8LWVtTQDwZFgkVPTZVekVeMy5VQUkfXiggTCRbDngkEg==",
      "name": "明美公園",
      "city": "台北市",
      "town": "內湖區",
      "type": "地點",
      "cat": "公園",
      "distance": 0.076
    },
    {
      "id": "NzYqAQYCRxsDWl5TDSlXFgABEEJ+dThAMBsPcFkGSCgSFjJKc14kEg==",
      "place_id": "NzYqAQYCRxsDWl5TDSlXFgABEEJ+dThAMBsPcFkGSCgSFjJKc14kEg==",
      "name": "明美藥局",
      "city": "台北市",
      "town": "中山區",
      "type": "地點",
      "cat": "藥局",
      "distance": 6.211
    },
    {
      "id": "NzYqAQYBRh4KXFtTQS9dNFVSTSdqeQsBQgdAX15OJDglHhtWAgM8Eg==",
      "place_id": "NzYqAQYBRh4KXFtTQS9dNFVSTSdqeQsBQgdAX15OJDglHhtWAgM8Eg==",
      "name": "明美精品",
      "city": "台南市",
      "town": "中西區",
      "type": "地點",
      "cat": "購物商場",
      "distance": 269.393
    },
    {
      "id": "NzYqAQYBTR4EXV5TAw5SPT88DxxbAAJ8Py99V2BNEk4kPCVpfwRNEg==",
      "place_id": "NzYqAQYBTR4EXV5TAw5SPT88DxxbAAJ8Py99V2BNEk4kPCVpfwRNEg==",
      "name": "明美藥局",
      "city": "屏東縣",
      "town": "屏東市",
      "type": "地點",
      "cat": "藥局",
      "distance": 289.058
    },
    {
      "id": "NzYqAQYHRRwAXlhTDlt1LlcrDR10DzhiBzlDdw17VU8uTgFIeQAWEg==",
      "place_id": "NzYqAQYHRRwAXlhTDlt1LlcrDR10DzhiBzlDdw17VU8uTgFIeQAWEg==",
      "name": "三明美食",
      "city": "新北市",
      "town": "萬里區",
      "type": "地點",
      "cat": "中式美食",
      "distance": 18.022
    },
    {
      "id": "NzYqAQYGQhcKW1xTAhoFVzYxICVdRglGBh5ye2BmSAAvODBjQlgwEg==",
      "place_id": "NzYqAQYGQhcKW1xTAhoFVzYxICVdRglGBh5ye2BmSAAvODBjQlgwEg==",
      "name": "明美寢具行",
      "city": "台北市",
      "town": "中山區",
      "type": "地點",
      "cat": "居家修繕",
      "distance": 5.743
    },
    {
      "id": "NzYqAQYGQRgDVlNTMF4BAFEdOi1tDjtWJ15BBH1nFgsQPDt2Y3Q4Eg==",
      "place_id": "NzYqAQYGQRgDVlNTMF4BAFEdOi1tDjtWJ15BBH1nFgsQPDt2Y3Q4Eg==",
      "name": "明美服裝行",
      "city": "台北市",
      "town": "萬華區",
      "type": "地點",
      "cat": "購物商場",
      "distance": 8.251
    },
    {
      "id": "NzYqAQYGQRgDV1pTAC1xCjATMRJ6cy1RNRt/eWFBF00PCQ9VQlU0Eg==",
      "place_id": "NzYqAQYGQRgDV1pTAC1xCjATMRJ6cy1RNRt/eWFBF00PCQ9VQlU0Eg==",
      "name": "明美時裝社",
      "city": "台北市",
      "town": "萬華區",
      "type": "地點",
      "cat": "購物商場",
      "distance": 8.945
    },
    {
      "id": "NzYqAQYBTRoFVlpTFFx9TApAUkVyZx17OlMORgoMLRARLx1CelU4Eg==",
      "place_id": "NzYqAQYBTRoFVlpTFFx9TApAUkVyZx17OlMORgoMLRARLx1CelU4Eg==",
      "name": "明美傢俱行",
      "city": "新北市",
      "town": "三峽區",
      "type": "地點",
      "cat": "居家修繕",
      "distance": 25.959
    }
  ]
}

讓使用者邊輸入，便邊回應出推測的可能清單 -- 運用在逐字逼近搜尋目標物的場景上。

[Places] 地址定位與反定位

功能 :

Geocoding API

Syntax 

https://api.map8.zone/v2/place/geocode/json?key=<您的 key>
    &address=<地址>
    &latlng=<緯度>,<經度>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

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

HTTP GET "https://api.map8.zone/v2/place/geocode/json?key=<您的 key>&address=台北市內湖區港墘路200號"

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "results": [
        {
            "formatted_address": "台北市內湖區港墘路200號",
            "geometry": {
                "location": {
                    "lat": 25.0759040326,
                    "lng": 121.574494301
                }
            },
            "id": "IykqAAIDRhYCWFpTQj9eUSE7PBZUThABOwtXcn5SHxYiDzsFflo0Eg==",
            "place_id": "IykqAAIDRhYCWFpTQj9eUSE7PBZUThABOwtXcn5SHxYiDzsFflo0Eg==",
            "name": "港墘路200號",
            "city": "台北市",
            "town": "內湖區",
            "type": "地址",
            "postcode": "114",
            "level": "1",
            "likelihood": -1,
            "authoritative": "true"
        }
    ],
    "status": "OK"
}

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

HTTP GET "https://api.map8.zone/v2/place/geocode/json?key=<您的 key>&latlng=25.0759040326,121.574494301"

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "results": [
        {
            "formatted_address": "114 台北市內湖區港墘路200號",
            "name": "港墘路200號",
            "city": "台北市",
            "town": "內湖區"
        }
    ],
    "status": "OK"
}

Example : 反地址定位 (帶入 latlng 參數，並要求三碼郵遞區號)

HTTP GET "https://api.map8.zone/v2/place/geocode/json?key=<您的 key>&latlng=25.0759040326,121.574494301&postcode=true"

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "results": [
        {
            "formatted_address": "台北市內湖區港墘路200號",
            "name": "港墘路200號",
            "city": "台北市",
            "town": "內湖區",
            "postcode": "114"
        }
    ],
    "status": "OK"
}

Example : 反地址定位 (帶入 latlng 參數，並要求三碼郵遞區號直接內嵌於 formatted_address 欄位)

HTTP GET "https://api.map8.zone/v2/place/geocode/json?key=<您的 key>&latlng=25.0759040326,121.574494301&postcode=true&formatted_address_embed_postcode=true"

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "results": [
        {
            "formatted_address": "114 台北市內湖區港墘路200號",
            "name": "港墘路200號",
            "city": "台北市",
            "town": "內湖區"
        }
    ],
    "status": "OK"
}

[Maps] 嵌入動態地圖

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

Maps Embed API

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

https://maps.map8.zone/?key=<您的 key>&title=研鼎智能&address=台北市內湖區港墘路200號4樓&description=台灣圖霸，有口皆碑#15.6/25.075904/121.574494

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

https://maps.map8.zone/?key=<您的 key>&title=研鼎智能&address=台北市內湖區港墘路200號4樓&description=台灣圖霸，有口皆碑#15.6/25.075904/121.574494/0/50

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

<iframe src="https://maps.map8.zone/?key=<您的 key>&title=研鼎智能&address=台北市內湖區港墘路200號4樓&description=台灣圖霸，有口皆碑#15.6/25.075904/121.574494/0/50" width="640" height="480">使用 <a href="https://www.map8.zone">台灣圖霸</a> 顯示 <a href="https://maps.map8.zone/?&title=研鼎智能&address=台北市內湖區港墘路200號4樓&description=台灣圖霸，有口皆碑#15.6/25.075904/121.574494/0/50">地圖 (台灣圖霸地圖平台 Map8 Platform  https://www.map8.zone)</a></iframe>

Maps embed api iframe example 7

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

[Maps] 地圖靜態圖片

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

Maps Static API

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

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

Maps static api demo

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

[Routes] 路徑規劃

功能 : 多點路徑規劃、多點旅行之距離時間矩陣

多點路徑規劃 API (Directions API)

Syntax 

https://api.map8.zone/route/<交通工具>/<起訖點座標組>.json?key=<您的 key>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example : 此例以 car (汽車) 作為交通工具 (請於瀏覽器直接打開)

HTTP GET "https://api.map8.zone/route/car/121.574494,25.075904;121.576499,25.068178;121.579343,25.068134.json?key=<您的 key>"

{
    "routes": [
        {
            "geometry": {
                "coordinates": [
                    [
                        121.574564,
                        25.075867
                    ],
                    [
                        121.574525,
                        25.075806
                    ],
                    [
                        121.574466,
                        25.075726
                    ],
                    ... (此為經緯度座標陣列, 供繪製地圖之用; 略)...
                ],
                "type": "LineString"
            },
            "legs": [
                {
                    "steps": [],
                    "distance": 1244,
                    "duration": 204,
                    "summary": "港墘路, 舊宗路二段"
                },
                {
                    "steps": [],
                    "distance": 406,
                    "duration": 63,
                    "summary": "瑞湖街, 民權東路六段11巷"
                }
            ],
            "distance": 1650,
            "duration": 267
        }
    ],
    "waypoints": [
        {
            "distance": 8,
            "name": "港墘路",
            "location": [
                121.574564,
                25.075867
            ]
        },
        {
            "distance": 0,
            "name": "瑞湖街",
            "location": [
                121.576499,
                25.068178
            ]
        },
        {
            "distance": 0,
            "name": "民權東路六段15巷",
            "location": [
                121.579343,
                25.068134
            ]
        }
    ]
}

（多點) 路徑規劃功能 : 依給定之起點、中途點 (零或多個)、與目的地之順序，以 Map8 的圖資與演算法來進行多點路徑規劃。

(排班) 多點運算交通時間距離矩陣 API (Distance Matrix API)

Syntax 

https://api.map8.zone/distancematrix/<交通工具>/<地點座標組>.json?key=<您的 key>&sourceIndices=<指定於地點座標組內之索引陣列以作為出發地>&destinationIndices=<指定於地點座標組內之索引陣列以作為目的地>&origins=<出發地之陣列>&destinations=<目的地之陣列>&annotations=<距離或時間>&language=<語系>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

範例 (1) : 此例以 car (汽車) 作為交通工具，並採取 (方式一) <地點座標組> 方式。透過 sourceIndices 與 destinationIndices 均不指定的方式，直接將全部的地點均作為出發地與目的地運算出矩陣。

HTTP GET "https://api.map8.zone/distancematrix/car/121.579839,25.065064;121.576499,25.068178;121.579343,25.068131.json?key=<您的 key>"

範例 (2) : 此例以 car (汽車) 作為交通工具，採取 (方式一) <地點座標組> 方式，並透過 sourceIndices 與 destinationIndices 指定出發地與目的地來運算出矩陣。

HTTP GET "https://api.map8.zone/distancematrix/car/121.579839,25.065064;121.576499,25.068178;121.579343,25.068131.json?key=<您的 key>&sourceIndices=0,1&destinationIndices=1,2"

範例 (3) : 此例以 car (汽車) 作為交通工具，並採取 (方式二) origins / destinations 方式指定出發地與目的地。

HTTP GET "https://api.map8.zone/distancematrix/car/json?key=<您的 key>&origins=place_id:NzYqAQYCRh4EW19THlt1Uys9NR5eQQNTQg8EWHRZEUlfNQFyWURBEg==&destinations=研鼎智能|內湖區行政中心&language=zh_TW"

上開範例 (3) 的回應結果 : 

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "destinations": [
        {
            "routePoint": {
                "location": [
                    121.574564,
                    25.075867
                ],
                "name": "港墘路",
                "distance": 8
            },
            "place": {
                "formatted_address": "台北市內湖區港墘路200號4樓之3",
                "geometry": {
                    "location": {
                        "lat": 25.075904,
                        "lng": 121.574494
                    }
                },
                "id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
                "place_id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
                "name": "研鼎智能股份有限公司",
                "city": "台北市",
                "town": "內湖區",
                "type": "地點",
                "level": "fuzzy",
                "likelihood": 75.59,
                "authoritative": "false"
            }
        },
        {
            "routePoint": {
                "location": [
                    120.343759,
                    22.629392
                ],
                "name": "光復路二段",
                "distance": 8
            },
            "place": {
                "formatted_address": "高雄市鳳山區光復路二段132號(高雄市政府鳳山行政中心內)",
                "geometry": {
                    "location": {
                        "lat": 22.629464,
                        "lng": 120.343762
                    }
                },
                "id": "NzYqAQYDQBgGXl1TGDxUCkwtMgV/cFNqFEVQfxdCCzcrMEFnfkdFEg==",
                "place_id": "NzYqAQYDQBgGXl1TGDxUCkwtMgV/cFNqFEVQfxdCCzcrMEFnfkdFEg==",
                "name": "中華郵政鳳山行政中心郵局",
                "city": "高雄市",
                "town": "鳳山區",
                "type": "地點",
                "level": "fuzzy",
                "likelihood": 46.15,
                "authoritative": "false"
            }
        }
    ],
    "origins": [
        {
            "routePoint": {
                "location": [
                    121.574564,
                    25.075867
                ],
                "name": "港墘路",
                "distance": 8
            },
            "place": {
                "formatted_address": "台北市內湖區港墘路200號4樓",
                "geometry": {
                    "location": {
                        "lat": 25.075904,
                        "lng": 121.574494
                    }
                },
                "id": "NzYqAQYCRh4EW19THlt1Uys9NR5eQQNTQg8EWHRZEUlfNQFyWURBEg==",
                "place_id": "NzYqAQYCRh4EW19THlt1Uys9NR5eQQNTQg8EWHRZEUlfNQFyWURBEg==",
                "name": "研勤科技股份有限公司(PAPAGO)",
                "city": "台北市",
                "town": "內湖區",
                "type": "地點",
                "level": "1",
                "likelihood": -1,
                "authoritative": "false"
            }
        }
    ],
    "rows": [
        {
            "elements": [
                {
                    "duration": {
                        "value": 1,
                        "text": "1 分鐘"
                    },
                    "distance": {
                        "value": 0,
                        "text": "1 公尺"
                    },
                    "status": "OK"
                },
                {
                    "duration": {
                        "value": 30208,
                        "text": "8 小時 23 分鐘"
                    },
                    "distance": {
                        "value": 352860,
                        "text": "353 公里"
                    },
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

運算多對多起訖點之交通時間距離矩陣 (Distance Matrix)。

請注意，本 API 提供您兩個方式來指定出發地與目的地 :

  1. (方式一) <地點座標組> : 先列出所有地點再指明哪些各為出發地與目的地

    • 此方式乃先以 GPS 座標方式列舉地點。
    • 可再搭配以 sourceIndices 與 destinationIndices (兩者均為索引值陣列) 來指定 <地點座標組> 其中的哪些地點分別各為出發地、目的地。
    • 若 sourceIndices 與 destinationIndices 未給，則 <地點座標組> 內的全部座標將均既作為出發地，也為目的地，來運算出矩陣。

  2. (方式二) origins / destinations : 出發地與目的地各自獨立列舉

    • 此方式為不先將座標全數列出 (再指明出發地 / 目的地)。
    • 反之，而是出發地與目的地，各自獨立列舉 (如同 Google Maps Ｐlatform 的 Distance Matrix API)。
    • 此外，出發地與目的地的列舉方式 (均為陣列形式)，除了座標，還可改以直接給地址。或是 Place API 所回應出的 place_id。

(排行程) 多途經點排序路徑規劃 API (Trip API)

Syntax 

https://api.map8.zone/trip/<交通工具>/<地點座標組>.json?key=<您的 key>&waypoints=<地點陣列>&source=<起點選項>&destination=<終點選項>&roundtrip=<是否返回出發地>&language=<語系>&overview=<路線總覽選項>&geometries=<路線繪製編碼選項>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

範例 (1) : 此例以 car (汽車) 作為交通工具，並採取 地點座標組 方式。不指定任何地點身為起點或終點，由系統預設返回起點的方式，進行路徑規劃並求出行程上每個地點都必須通過的最佳順序路徑 (語系指定為英文)。

HTTP GET "https://api.map8.zone/trip/car/121.574494,25.075904;121.574494,25.075904;121.585842,25.081139;121.575922,25.062935.json?key=<您的 key>&language=en_US"

範例 (2) : 此例以 car (汽車) 作為交通工具，採取 地點陣列 方式，指定起點並返回為條件，進行路徑規劃並求出行程上每個地點都必須通過的最佳順序路徑。

HTTP GET "https://api.map8.zone/trip/car/json?key=<您的 key>&waypoints=研鼎智能|碧湖公園|美麗華百樂園&source=first&roundtrip=true"

上開範例 (2) 的回應結果，您可以見到，給定的地點依序為 研鼎智能 (編號 0)、美麗華百樂園 (編號 1)、碧湖公園 (編號 2)。由於回應結果之 waypoints 陣列內物件依序即為運算求得的最佳順序，故依據 waypoint_index (依序為 0, 2, 1) 來解讀運算結果，可得系統規劃出之最佳順序為 研鼎智能 ⇒ 碧湖公園 ⇒ 美麗華百樂園 ⇒ 研鼎智能 (終點是因為指定了 roundtrip=true 要求返回起點)。如下 : 

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "trips": [
        {
            "waypoints": [
                {
                    "routePoint": {
                        "waypoint_index": 0,
                        "location": [
                            121.574564,
                            25.075867
                        ],
                        "name": "港墘路",
                        "distance": 8
                    },
                    "place": {
                        "formatted_address": "台北市內湖區港墘路200號4樓之3",
                        "geometry": {
                            "location": {
                                "lat": 25.075904,
                                "lng": 121.574494
                            }
                        },
                        "id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
                        "place_id": "NzYqAQYARhkCVltTRRxiJBIYMDIIZgVSLyMdf25eBDIIPQ1VHWEwEg==",
                        "name": "研鼎智能股份有限公司",
                        "city": "台北市",
                        "town": "內湖區",
                        "type": "地點",
                        "level": "fuzzy",
                        "likelihood": 75.59,
                        "authoritative": "false"
                    }
                },
                {
                    "routePoint": {
                        "waypoint_index": 2,
                        "location": [
                            121.585888,
                            25.08098
                        ],
                        "name": "內湖路二段",
                        "distance": 18
                    },
                    "place": {
                        "formatted_address": "台北市內湖區",
                        "geometry": {
                            "location": {
                                "lat": 25.081139,
                                "lng": 121.585842
                            }
                        },
                        "id": "NzYqAQYCRh4BWFlTGFtaLUxPSwBXUSJUNF94Glt7SDYTSC1DRXE8Eg==",
                        "place_id": "NzYqAQYCRh4BWFlTGFtaLUxPSwBXUSJUNF94Glt7SDYTSC1DRXE8Eg==",
                        "name": "碧湖公園",
                        "city": "台北市",
                        "town": "內湖區",
                        "type": "地點",
                        "level": "fuzzy",
                        "likelihood": 100,
                        "authoritative": "false"
                    }
                },
                {
                    "routePoint": {
                        "waypoint_index": 1,
                        "location": [
                            121.556378,
                            25.083069
                        ],
                        "name": "敬業三路",
                        "distance": 30
                    },
                    "place": {
                        "formatted_address": "台北市中山區敬業三路20號",
                        "geometry": {
                            "location": {
                                "lat": 25.083068,
                                "lng": 121.556674
                            }
                        },
                        "id": "NzYqAQYCRxsKV15TJiZiMBUIGht8RA9KIFtCSXN3BBMMMzZeUHZFEg==",
                        "place_id": "NzYqAQYCRxsKV15TJiZiMBUIGht8RA9KIFtCSXN3BBMMMzZeUHZFEg==",
                        "name": "美麗華百樂園",
                        "city": "台北市",
                        "town": "中山區",
                        "type": "地點",
                        "level": "fuzzy",
                        "likelihood": 81.65,
                        "authoritative": "false"
                    }
                }
            ],
            "duration": {
                "value": 1281,
                "text": "21 分鐘"
            },
            "distance": {
                "value": 7092,
                "text": "7.1 公里"
            },
            "geometry": {
                "coordinates": [
                    [
                        121.574564,
                        25.075867
                    ],
                    [
                        121.574525,
                        25.075806
                    ],
                    [
                        121.574466,
                        25.075726
                    ],
                    [
                        121.574402,
                        25.07565
                    ],
                     ... (此為經緯度座標陣列, 供繪製地圖之用; 略)...
                ],
                "type": "LineString"
            }
        }
    ],
    "status": "OK"
}

給定多途經點，排出次序並規劃路徑 (旅行業務員 / Travelling Salesman Problem (TSP) 最短路徑問題)

請注意，本 API 提供您兩個方式來指定出發地與目的地 :

  1. (方式一) <地點座標組> : 以 GPS 座標方式列舉地點。

  2. (方式二) <地點陣列> 給入地址或地名 :

    • 透過 waypoints 參數，直接給予地址 (或地點名稱)，讓台灣圖霸的 Geocoding API 自動為您進行搜尋定址。
    • 或是 place_id 方式 (參見 Find Place API) 來指定地點。
    • 當然，您也可以在這個參數內直接給入座標。

[Roads] 道路資訊

功能 : 取得道路屬性與黏路

道路屬性 API (Nearest Roads API)

Syntax 

https://api.map8.zone/road/nearestRoads/<交通工具>?key=<您的 key>
    &latlng=<緯度>,<經度>
    &additional_fields

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example : 此例以 car (汽車) 作為交通工具

HTTP GET "https://api.map8.zone/road/nearestRoads/car?key=<您的 key>&latlng=25.073448,121.544539&additional_fields=speed,elevated,height,bridge"

{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "results": [
    {
      "formatted_address": "台北市中山區 - 中山高汐五高架道路",
      "id": "",
      "place_id": "",
      "name": "中山高汐五高架道路",
      "city": "台北市",
      "town": "中山區",
      "type": "道路",
      "distance": 5.10,
      "speed": "100",
      "elevated": "1",
      "height": "",
      "bridge": ""
    }
  ],
  "status": "OK"
}

對道路進行反定址 (也就是由輸入之地理座標轉為道路)，並獲取道路屬性 (速限、高架、橋樑、限高）。

黏路 API (Snap to Roads API)

Syntax 

https://api.map8.zone/road/snapToRoads/<交通工具>/<路徑點座標組>.json?key=<您的 key>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example : 此例以 car (汽車) 作為交通工具

HTTP GET "https://api.map8.zone/road/snapToRoads/car/121.57454312639197,25.07650531765003;121.57471291748163,25.076413420485522;121.57465079878949,25.076233376861623;121.57481644863265,25.07592205080232;121.5746383750515,25.075674489756707;121.57407930683218,25.075520701582974.json?key=<您的 key>"

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "matchings": [
        {
            "tracepoints": [
                {
                    "alternatives_count": 0,
                    "waypoint_index": 0,
                    "location": [
                        121.57458,
                        25.076572
                    ],
                    "name": "瑞光路",
                    "distance": 8
                },
                {
                    "alternatives_count": 0,
                    "waypoint_index": 1,
                    "location": [
                        121.574756,
                        25.076492
                    ],
                    "name": "瑞光路",
                    "distance": 10
                },
                {
                    "alternatives_count": 0,
                    "waypoint_index": 2,
                    "location": [
                        121.574752,
                        25.076184
                    ],
                    "name": "港墘路",
                    "distance": 12
                },
                {
                    "alternatives_count": 0,
                    "waypoint_index": 3,
                    "location": [
                        121.574732,
                        25.075964
                    ],
                    "name": "港墘路",
                    "distance": 10
                },
                {
                    "alternatives_count": 0,
                    "waypoint_index": 4,
                    "location": [
                        121.574575,
                        25.075709
                    ],
                    "name": "港墘路",
                    "distance": 7
                },
                {
                    "alternatives_count": 0,
                    "waypoint_index": 5,
                    "location": [
                        121.574155,
                        25.075431
                    ],
                    "name": "港墘路",
                    "distance": 13
                }
            ],
            "geometry": {
                "coordinates": [
                    ... (此為經緯度座標陣列, 供繪製地圖之用; 略)...
                ],
                "type": "LineString"
            }
        }
    ],
    "status": "OK"
}

給定一路徑依序之座標點，對地圖黏岀最可能路徑 (黏路)。

[Address Validation] 地址正規化/地址校正/地址勘誤

功能 : 地址正規化/地址校正/地址勘誤

地址正規化 API (Address Standardization API)

Syntax 

https://api.map8.zone/v2/address/standardization?key=<您的 Key>&query=<地址>

提醒您 : 
URL 所有以 query string 形式帶入的參數，應當都要視情況，適當地經過 URL encode 編碼後再傳入。
以免發生錯誤而收到 HTTP 400 Bad Request。

Example

HTTP GET "https://api.map8.zone/v2/address/standardization?key=<您的 Key>&query=北市內湖區港墘路200號4樓之三"

{
    "html_attribution": [
        "台灣圖霸",
        "研鼎智能",
        "PAPAGO!"
    ],
    "results": [
        {
            "formatted_address": "臺北市內湖區港墘里港墘路200號四樓之３",
            "doorplateID": "2e35e1af-d0ad-4571-ab8f-c0e8dac69b0a",
            "postcode3": "114",
            "postcode33": "114721",
            "postcode32": "11494",
            "city": "臺北市",
            "town": "內湖區",
            "village": "港墘里",
            "lin": "20",
            "road": "港墘路",
            "hamlet": "",
            "lane": "",
            "alley": "",
            "lon": "",
            "num": "200號",
            "floor": "四樓之３",
            "numAttr": "",
            "residenceID": "ceadf149-e7fd-4d39-b0e2-fe72c674c098",
            "compType": "",
            "compDate": "",
            "trxDate": "",
            "geom": {
                "type": "Point",
                "coordinates": [
                    121.574365,
                    25.075977
                ]
            },
            "resultAnalysis": {
                "statusCode": [
                    0
                ],
                "redundantTextInQuery": ""
            },
            "history": []
        }
    ],
    "queryQuality": {
        {
            "statusCode": [
                0
            ]
        }
    },
    "status": "OK"   // 處理完成
}

台灣圖霸之 PAPAGO！ 商用地圖 擁有全台灣 988 萬筆門牌資料，精確到樓層！ 台灣圖霸，擁有全台灣超過 3000 萬筆新舊門牌資料庫，時時同步更新政府戶政司資料，提供最新地址現況

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 表示是我們的伺服器端的錯誤；再重試一次可能就會成功。如果持續發生此問題，請跟我們聯絡


https://map8.zone

地點類型

所支援的景點類型，為字串，如下 :

範例