台南市民服務熱線 .English  .回首頁  .網站導覽
台南1999Baner
 
Open1999
服務說明
網路電話
常見問題集
案件查詢
統計資訊
 
API說明
 
相關連結
^
臺南市市民手冊
臺南市政府資料開放平台
臺南市政府資料開放平台
v
 
 

A+無障礙標章


臺南市政府資料開放系統技術指南

  臺南市政府資料開放系統提供派工通報資料,民眾或機關可在網站或以Open API介接方式取得通報資料,每個通報服務查詢資料均有列出格式及欄位定義,協助開發人員充分了解資料內容或應使用的介接技術,針對較複雜的API,並於系統點擊”使用說明”時即提供相關說明。

  本文件針對API的使用方式進行說明。

一、服務案件批次查詢(GET Service Requests):

   提供查詢派工通報資料內容。

   服務名稱:ServiceRequestsQuery

   URL:http://open1999.tainan.gov.tw:82/ServiceRequestsQuery.aspx

   編碼:UTF-8

   傳遞參數格式:XML

   參數說明:

    city_id:城市識別碼

    service_request_id:案件編號【多筆以逗號(,)分隔】

    service_name:案件類型【多筆以逗號(,)分隔】,可使用API服務ServiceList來查詢可使用條件。

    start_date:反映開始時間

    end_date:反映結束時間

    status:案件狀態

   參數內容及限制:

    1.service_request_id、service_name、start_date、end_date及status擇一查詢。

    2.service_request_id:條件最多1000筆。

    3.service_name:條件最多1000筆,可使用API服務ServiceList來查詢可使用條件。

    4.status:可查詢條件【處理中、已完成】。

   返回參數:

    returncode:0表示成功,其它表示不成功

    description:錯誤說明【操作失敗才會顯示】

    stacktrace:錯誤Log【操作失敗才會顯示】

    count:結果筆數

    records:多筆查詢結果

    record:每筆資料

    service_request_id:案件編號

    requested_datetime:反映日期

    status:案件狀態

    keyword:案件描述

    area:行政區

    service_name:案件類型

    agency:業管單位

    subproject:案件事項

    description:案件內容

    address_string:地點

    lat:緯度

    long:經度

    service_notice:服務案件說明

    updated_datetime:結案日期

    expected_datetime:預計完成日期

    pictures:多筆處理前照片

    picture:每筆處理前照片

    description:照片描述

    fileName:檔案名稱

    file:檔案資料

   返回參數內容及限制:

    1.回傳結果最多5000筆。

    2.file:byte格式。

二、服務請求新增(POST Service Request):

您如需新增大量案件(如開發APP協力通報),請先與我們聯繫 weiwuwu @mail.tainan.gov.tw

我們將提供相關測試網站

   提供新增派工通報資料。

   URL:http://open1999.tainan.gov.tw:82/ServiceRequestAdd.aspx

   服務名稱:ServiceRequestAdd

   編碼:UTF-8

   傳遞參數格式:XML

   參數說明:

    city_id:城市識別碼

    area:行政區

    address_string:地點

    lat:緯度(WGS84)

    long:經度(WGS84)

    email:E-MAIL

    device_id:僅用於行動裝置

    name:姓名

    phone:電話

    service_name:案件類型

    subproject:案件事項

    description:案件內容

    pictures:上傳照片

    description:照片描述

    fileName:檔案名稱

    file:檔案資料

   參數內容及限制:

    1.必填欄位:city_id、area、address_string、name、phone、service_name、subproject、description。

    2.service_name:可使用API服務ServiceList來查詢可新增條件。

    3.subproject:參考案件事項對應案件內容表。下載案件事項對應案件內容表

    4.pictures:最多三筆,檔案大小總和限制3MB以下。

    5.fileName:需含副檔名且檔案類型限制JPG。

    6.file:byte格式。

   返回參數:

    returncode:0表示成功,其它表示不成功

    description:錯誤說明【操作失敗才會顯示】

    stacktrace:錯誤Log【操作失敗才會顯示】

    service_request_id:案件編號

    token:token

    service_notice:服務說明

    count:結果筆數

   返回參數內容及限制:

    無

三、服務案件查詢(GET Service Request):

   提供查詢派工通報資料內容。

   服務名稱:ServiceRequestQuery

   URL:http://open1999.tainan.gov.tw:82/ServiceRequestQuery.aspx

   編碼:UTF-8

   傳遞參數格式:XML

   參數說明:

    city_id:城市識別碼

    service_request_id:案件編號

   參數內容及限制:

    1.service_request_id必需輸入。

    2.service_name:案件類型名稱可使用API服務ServiceList來進行查詢。

   返回參數:

    returncode:0表示成功,其它表示不成功

    description:錯誤說明【操作失敗才會顯示】

    stacktrace:錯誤Log【操作失敗才會顯示】

    count:結果筆數

    records:多筆查詢結果

    record:每筆資料

    service_request_id:案件編號

    requested_datetime:反映日期

    status:案件狀態

    keyword:案件描述

    area:行政區

    service_name:案件類型

    agency:業管單位

    subproject:案件事項

    description:案件內容

    address_string:地點

    lat:緯度

    long:經度

    service_notice:服務案件說明

    updated_datetime:結案日期

    expected_datetime:預計完成日期

    pictures:多筆處理前照片

    picture:每筆處理前照片

    description:照片描述

    fileName:檔案名稱

    file:檔案資料

   返回參數內容及限制:

    1.回傳結果最多5000筆。

    2.file:byte格式。

四、服務列表查詢(GET Service List):

   查詢服務列表(查詢所提供的案件服務類型及其代碼)。

   服務名稱:ServiceRequestQuery

   URL:http://open1999.tainan.gov.tw:82/ServiceList.aspx

   編碼:UTF-8

   傳遞參數格式:XML

   參數說明:

    city_id:城市識別碼

   參數內容及限制:

    無

   返回參數:

    returncode:0表示成功,其它表示不成功

    description:錯誤說明【操作失敗才會顯示】

    stacktrace:錯誤Log【操作失敗才會顯示】

    count:結果筆數

    records:多筆查詢結果

    record:每筆資料

    service_code:服務類別代碼

    service_name:服務名稱

    description:服務說明

    metadata:是否有定義擴充資料(是/否)

    type:產生方式(realtime/batch/black)

    keywords:服務相關關鍵字【多筆以逗號(,)分隔】

    subproject:服務包含哪些次類別【多筆以逗號(,)分隔】

   返回參數內容及限制:

    1.回傳結果最多30筆。

使用說明

一、服務案件批次查詢(GET Service Requests)

   URL:http://open1999.tainan.gov.tw:82/ServiceRequestsQuery.aspx

   呼叫參數:

   呼叫參數

   返回參數:

   返回參數

   應用範例:

   範例:ASP.NET

    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(URL);
    request.ContentType = "text/xml";
    request.Method = "POST";
    using (StreamWriter streamWriter = new StreamWriter(request.GetRequestStream()))
    {
        streamWriter.Write(呼叫參數);
        streamWriter.Flush();
        streamWriter.Close();

        HttpWebResponse httpResponse = (HttpWebResponse)request.GetResponse();
        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
        {
            返回參數 = streamReader.ReadToEnd();
        }
    }
                                

二、服務請求新增(POST Service Request)

   應用範例:

   URL:http://open1999.tainan.gov.tw:82/ServiceRequestAdd.aspx

   呼叫參數:

   呼叫參數

   返回參數:

   返回參數

   應用範例:

   範例:ASP.NET

    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(URL);
    request.ContentType = "text/xml";
    request.Method = "POST";
    using (StreamWriter streamWriter = new StreamWriter(request.GetRequestStream()))
    {
        streamWriter.Write(呼叫參數);
        streamWriter.Flush();
        streamWriter.Close();

        HttpWebResponse httpResponse = (HttpWebResponse)request.GetResponse();
        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
        {
            返回參數 = streamReader.ReadToEnd();
        }
    }
				                

三、服務案件查詢(GET Service Request)

   URL:http://open1999.tainan.gov.tw:82/ServiceRequestQuery.aspx

   呼叫參數:

   呼叫參數

   返回參數:

   返回參數

   應用範例:

   範例:ASP.NET

    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(URL);
    request.ContentType = "text/xml";
    request.Method = "POST";
    using (StreamWriter streamWriter = new StreamWriter(request.GetRequestStream()))
    {
        streamWriter.Write(呼叫參數);
        streamWriter.Flush();
        streamWriter.Close();

        HttpWebResponse httpResponse = (HttpWebResponse)request.GetResponse();
        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
        {
            返回參數 = streamReader.ReadToEnd();
        }
    }
                                

四、服務列表查詢(GET Service List)

   URL:http://open1999.tainan.gov.tw:82/ServiceList.aspx

   呼叫參數:

   呼叫參數

   返回參數:

   返回參數

   應用範例:

   範例:ASP.NET

    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(URL);
    request.ContentType = "text/xml";
    request.Method = "POST";
    using (StreamWriter streamWriter = new StreamWriter(request.GetRequestStream()))
    {
        streamWriter.Write(呼叫參數);
        streamWriter.Flush();
        streamWriter.Close();

        HttpWebResponse httpResponse = (HttpWebResponse)request.GetResponse();
        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
        {
            返回參數 = streamReader.ReadToEnd();
        }
    }
                                

常見問題

● 平台資料之取得是否免費使用?授權的方式為何?

  平台開放之資料集以免費為原則,以無償及非專屬授權方式授權使用者得不限時間及地域,重製、改作、編輯、公開傳輸或為其他利用方式,開發各種產品或服務,提供公眾使用,無須取得各資料提供機關之書面或其他方式授權。

● 為何回傳的參數中文字為亂碼?

  呼叫及返回參數資料採用國際通用編碼格式「UTF-8」,因此使用Open API傳接參數時將編碼調整為「UTF-8」格式即可。

● 台南1999APP的服務有哪些?

  台南1999APP提供的服務,以快速案件通報為主,包含了民眾最關心的噪音、違規停車、汙染等常見問題,市民朋友使用APP通報案件,市府將在一定的期限內處理完成。
  其次,台南1999APP也提供案件查詢的功能,以及一般陳情、檢舉的功能。然而,如果案情複雜,需要輸入大量文字說明,我們仍建議您直接撥打1999。

● 我使用台南1999APP通報的案件資料會被別人看到嗎?

  是的,部分資料會被看到。
  使用台南1999APP、網頁或撥打1999通報案件,未來都將於1999主題網站公布案件資料,包含了立案日期、結案日期、案件類別、描述、地點等資訊,以及您所上傳的照片。然而,有關個人資料的部分,我們將依「個人資料保護法」規定,不會在該網站上公開。

● 我使用台南1999APP撥打1999要收費嗎?

  是的。台南1999是付費電話,行動電話撥打1999費率介於每分鐘2.88~3.6元(原則以秒計費)。

隱私權保護政策

● 適用範圍

  以下的隱私權保護政策,適用於您在台南1999APP以及1999主題網站(http://1999.tainan.gov.tw/)活動時,所涉及有關個人資料收集、運用與保護。

● 個人資料收集方式

  當您進入本APP及主題網新增或查詢案件時,依據「臺南市政府及所屬機關處理人民陳情作業要點」,需請您提供姓名、電話、電子信箱、性別及住址等個人資訊,限於公務處理使用,若您選擇不提供或提供非正確資料,受理機關有權不予處理;若是您冒名檢舉要自行負擔法律責任。

● 個人資料的運用方式

  本APP及網站不會出售、出租或任意交換任何您的個人資料給其他團體或個人。只有在統計與分析之需求的前提下,本APP及網站根據伺服器日誌文件,對使用者的人數和行為進行內部研究。此研究是根據全體使用者的資料進行統計分析與整理,而所有的公開資訊或分析報告,將僅對全體使用者行為總和進行分析及公佈,並不會提供特定對象個別資料之分析報告。

● 資料的分享與公開方式

  本APP及網站不會任意出售、交換、或出租任何您的個人資料給其他團體或個人。只有在以下狀況會在本政策原則之下,與第三者共用您的個人資料︰
  本APP及網站有義務保護其網友隱私及個人資料,非經您本人同意不會自行修改、刪除或提供任何(或部份)使用者個人資料。除非經過您事先同意或符合以下情況:
  (1)中華民國司法檢調單位透過合法程序進行調閱。
  (2)違反網站相關規章且已造成脅迫性。
  (3)基於主動衍伸政府網站服務效益之考量。
  (4)保護其他網友之合法使用權益。

1999Logo 電話:台南市民服務熱線1999(以市話撥打依市話費率計收,行動撥打費率約為每秒0.06元,詳依各家行動業者公告費率為準)、886-6-6326303
服務時間:24小時全年無休                                       |隱私權聲明|