摘要內容
TGOS MAP API (iOS)開發人員指南
用TGOS MAP API開啟視野
本指南是給以iOS環境設計APP程式的開發人員，如何將TGOS MAP API (iOS)功能嵌入APP程式的使用教程。在閱讀本指南並開始利用TGOS MAP API多元而豐富的功能，來充實您的網頁之前，您需要有iOS程式設計方法的基礎，並建立開發環境。本指南將使用Xcode開發工具於Mac OS系統上進行範例展示，也建議您使用Mac裝載Xcode來開發您的APP程式。
範例程式使用注意事項
開發過程中，您可能會參考本網站範例說明，並下載網站提供的範例程式。在使用這些範例程式時，請您特別注意以下項目說明，將會讓您使用上更加便利，且不致出現錯誤。
1. 個別功能範例中，僅提供該功能相關之範例專案檔，如有需要檢視範例專案裡的功能，您必須先下載TGOS MAP API (iOS) SDK後並載入，且設置您申請取得的AppID及APIKey，才能正確的操作範例檔案。快速範例則已經包含SDK，僅需於載入後設置AppID及APIKey即可正常使用。
2. 網站提供的所有範例，皆使用UTF-8編碼。您開啟範例後若發現中文字產生亂碼的現象，請由Window工具列開啟Preferences，選擇General項目中的Workspace子項目，並找到Text file encoding方塊，點選Other後在下拉式選單選擇UTF-8即可。您所開發的APP程式則不在此限，您也可在此為您的APP程式選取想用的編碼方式。
3. 請於Mac系統上解壓讀取網站所提供的SDK及範例檔案，若使用Windows系統解壓縮，將造成檔案解譯的錯誤。建議您全程使用Mac系統進行開發，以避免造成不必要的問題。
取得API金鑰
您必須先取得API金鑰，才能使用TGOS MAP API。API金鑰可以在您使用上或流量有問題時，讓TGOS團隊及時瞭解情形，協助您處理。申請使用TGOS MAP API為免費的，若您還未取得API金鑰，可以到申請網頁進行申請。
建立新專案
使用Xcode開發工具中立一個新專案(Single View Application)來初始化您的APP程式，TGOS MAP API (iOS)支援iOS 5.0以上之環境。
加入框架及參照
為了確保您的APP程式正確使用TGOS MAP API (iOS)的各項功能，必需提供程式管理或使用iOS及OS X上部分功能的權限。選擇專案檔的TARGETS項目，並從General頁籤最下方的「Linked Frameworks and Libraries」區塊中，點選「+」號開啟框架及參照清單，加入以下框架及參照。
●AVFoundation.framework
●CoreMotion.framework
●CoreLocation.framework
●QuartzCore.framework
●libxml2.dylib
將TGOS MAP API (iOS)開發工具加入參照
要在專案中加入地圖功能，必須先載入TGOS MAP API (iOS) SDK，請先下載SDK到您的電腦中，並進行解壓縮。選擇專案檔的TARGETS項目，並從General頁籤最下方的「Linked Frameworks and Libraries」區塊中，點選「+」號開啟框架及參照清單，由「Add Other…」按鈕加入已存在您電腦中的SDK(請先行解壓縮)，即可進行後續開發工作。
在載入TGOS MAP API (iOS) SDK時，必需設置API金鑰參數，請將yourID及yourkey填入為您申請所取得的API金鑰，包含APPID及APIKEY，方能順利驗證載入必要之功能。
在程式中初始化地圖
在程式頁面初始化地圖畫面之前，必須先將已在參照清單中的TGOS MAP API (iOS) SDK讀取到頁面中。使用import指令，在每個需要加入地圖畫面的頁面.m檔加入TGMaps.h參照。
#import <TGMaps/TGMaps.h>
以下程式碼將初始化一個最簡單的TGOS MAP，我們將以此程式做為範例來介紹，您也可以在想加入地圖頁面的.m檔中，以此段程式碼做為基礎進行開發。
{
TGMapView *mapView_;
}
- (void)loadView
{
mapView_ = [[TGMapView alloc]initWithFrame:CGRectZero]; //建立地圖
self.view = mapView_;
mapView_.viewer = [TGViewerPosition viewerWithLatitude:23.58 longitude:120.95 zoom:1];
//設定畫面初始位置
[mapView_ starRendering]; //畫面更新
}
在上列程式碼中，指定mapView_為一個包含TGMapView的畫面，並將畫面加入到程式頁面中，接著以TGViewerPosition儲存地圖圖窗初始位置屬性，最後再使畫面更新，即可在程式中顯示最簡單的TGOS地圖。
