Google地圖API專業(yè)版開發(fā)人員指南講課教案

1、Good is good, but better carries it.精益求精，善益求善。Google地圖API專業(yè)版開發(fā)人員指南Google地圖API專業(yè)版開發(fā)人員指南Google地圖API可讓您向自己的公共網(wǎng)站添加易于使用的交互式地圖，通過幫助客戶從您的組織中找到他們真正所需的內(nèi)容來改善客戶體驗。這就是該API成為全球最受歡迎的地圖繪制API的原因。當(dāng)Google地圖在您的公共網(wǎng)站上起很重要的作用，或者已納入到內(nèi)部應(yīng)用程序中以供您的員工使用時，組織需要一種企業(yè)級應(yīng)用程序來處理大量工作并提供必要的支持。HYPERLINK/intl/zh-CN/apis/maps/documentation

2、/premier/guide.htmllWhyPremiert_blank為何要使用Google地圖API專業(yè)版？HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllSignupt_blank指定“客戶端ID”HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllSensort_blank使用sensor參數(shù)跟蹤使用情況HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmll

3、Accessingt_blank訪問和加載APIHYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllClientIDt_blank使用client參數(shù)加載JavaScriptAPIHYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllCommonLoadert_blank使用通用加載程序加載JavaScriptAPIHYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllFl

4、asht_blank加載GoogleMapsAPI（Flash版）HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllServicest_blank使用地圖API服務(wù)HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllStaticMapst_blank靜態(tài)地圖APIHYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllGeocodingt_blank地址解析服務(wù)HYPER

5、LINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllSupportt_blank支持為何要使用Google地圖API專業(yè)版？Google地圖API專業(yè)版可提供針對企業(yè)的應(yīng)用程序支持，以滿足您的地圖繪制應(yīng)用程序需求。Google地圖API專業(yè)版所使用的代碼庫與標(biāo)準(zhǔn)Google地圖API相同，但它還提供以下附加功能和優(yōu)點：強大的服務(wù)級別協(xié)議(SLA)客戶支持增加的地址解析限制商業(yè)級條款企業(yè)內(nèi)的Intranet應(yīng)用程序支持通過安全的https連接對API進(jìn)行訪問Google地圖API專業(yè)版要求先注冊您的網(wǎng)站才能訪問這些附加功能。有關(guān)詳

6、細(xì)信息，請HYPERLINK/enterprise/gmet_blank聯(lián)系我們。本文檔介紹了Google地圖API專業(yè)版產(chǎn)品特定的使用案例和編碼問題。有關(guān)所有通用代碼的完整文檔，請參考現(xiàn)有的HYPERLINK/apis/maps/documentation/t_blankGoogle地圖API文檔來使用本指南。指定“客戶端ID”要訪問Google地圖API專業(yè)版的特殊功能，您必須在訪問任何專業(yè)版API庫或服務(wù)時都提供“客戶端ID”。當(dāng)注冊使用Google地圖API專業(yè)版時，可從Google企業(yè)支持處獲得此“客戶端ID”。所有客戶端ID都以gme-前綴開頭。您的客戶端ID可以與一個或多個網(wǎng)站域

7、關(guān)聯(lián)。對于現(xiàn)有客戶而言，您以前通過發(fā)布API密鑰關(guān)聯(lián)到您的專業(yè)版帳戶的所有域都會自動添加至您的帳戶。如果希望獲得您當(dāng)前啟用的域的列表，或希望為您的客戶端ID啟用其他域，請聯(lián)系Google企業(yè)支持。可為您的客戶端ID啟用的域的數(shù)量不限。注意：此客戶端ID不是密鑰。它只在您授權(quán)的域起作用，因此您無需擔(dān)心它的保密性。當(dāng)Google地圖API專業(yè)版用戶使用該地圖API或它的某項服務(wù)時，不再需要進(jìn)行注冊或提供API密鑰。使用sensor參數(shù)跟蹤使用情況現(xiàn)在，使用Google地圖API時，需要指明您的應(yīng)用程序在任何地圖API庫或服務(wù)請求中是否使用傳感器（例如GPS定位器）確定用戶的位置。這對移動設(shè)備尤為重

8、要。如果Google地圖API應(yīng)用程序使用任何形式的傳感器來確定訪問您的應(yīng)用程序的設(shè)備的位置，則必須通過將sensor參數(shù)值設(shè)置為true來聲明這一點。請注意，即使您的應(yīng)用程序未使用任何位置傳感器，仍需要設(shè)置sensor參數(shù)（在本例中設(shè)置為false）。訪問和加載API將地圖API庫或服務(wù)加載為專業(yè)版應(yīng)用程序需要通過client參數(shù)指定客戶端ID。指定該值的具體方式取決于您所使用的庫或服務(wù)。使用client參數(shù)加載JavaScriptAPI要使用您的Google地圖API專業(yè)版客戶端ID加載Google地圖JavaScriptAPI，需要將額外的client參數(shù)附加到用來檢索JavaScrip

9、t庫的網(wǎng)址：請注意，您無需在該網(wǎng)址中提供API密鑰，但必須提供sensor參數(shù)。Google地圖API專業(yè)版客戶還可以通過https訪問Google地圖JavaScriptAPI。要通過https使用Google地圖JavaScriptAPI，首先必須由Google企業(yè)支持允許您的客戶端ID啟用HTTPS訪問。如果未允許您的客戶端使用https，則請求將重定向到HTTP。要通過https加載Google地圖JavaScriptAPI，需要使用HTTPS協(xié)議并從以下網(wǎng)址加載API：使用通用加載程序加載JavaScriptAPIGoogle地圖JavaScriptAPI現(xiàn)在已與GoogleAJAX

10、API完全集成，如HYPERLINK/apis/maps/documentation/lAJAX_Loadert_blank/apis/maps/documentation/#AJAX_Loader中所述。如果希望通過Google地圖API專業(yè)版客戶端ID加載Google地圖JavaScriptAPI，則加載通用加載程序時無需提供API密鑰：使用通用加載程序加載Google地圖JavaScriptAPI時，需要通過other_params選項提供您的客戶端ID：google.load(maps,2,other_params:client=gme-yourclientid&sensor=fals

11、e);Google地圖API專業(yè)版客戶還可以通過https加載Google地圖JavaScriptAPI。要通過https使用Google地圖JavaScriptAPI，首先必須由Google企業(yè)支持允許您的客戶端ID啟用HTTPS訪問。要使用GoogleAJAXAPI加載程序通過https加載Google地圖JavaScriptAPI，請先通過https加載通用加載程序：加載后，即可使用google.load()加載Google地圖JavaScriptAPI（如上所示）。通過https提出Google地圖JavaScriptAPI的請求時，如果通過尚未允許啟用https訪問的客戶端ID使用通

12、用加載程序加載地圖API，則會重定向至HTTP。加載GoogleMapsAPI（Flash版）您的Google地圖API專業(yè)版客戶端ID還可讓您以企業(yè)應(yīng)用程序的形式訪問GoogleMapsAPI（Flash版）。有關(guān)GoogleMapsAPI（Flash版）的完整文檔，請訪問HYPERLINK/apis/maps/documentation/flash/t_blank/apis/maps/documentation/flash/。與JavaScriptAPI一樣，當(dāng)您訪問該API時，雖然不需要提供API密鑰，但卻需要傳遞client和sensor參數(shù)。注意：GoogleMapsAPI（Flas

13、h版）可讓使用不低于1.8b版HYPERLINK/maps/flash/release/sdk.zipt_blankFlashSDK的專業(yè)版客戶免去提供API密鑰的必要。請確保使用不低于1.8b的版本編譯您的應(yīng)用程序，以利用無需提供密鑰即可訪問的功能?，F(xiàn)有的應(yīng)用程序需要用該版本重新編譯，才能享受無需提供密鑰的支持。訪問GoogleMapsAPI（Flash版）時，可通過三種方式來提供您的Google地圖API專業(yè)版客戶端ID。無論選擇哪種方式，都建議您用同一種方式提供您的客戶端ID和sensor參數(shù)：將您的客戶端ID和sensor參數(shù)作為在MXML中聲明的UI容器對象的屬性來提供：如果您使用F

14、lexBuilder或FlexFramework開發(fā)應(yīng)用程序，應(yīng)首選此方法。將您的客戶端ID和sensor參數(shù)作為object和embed標(biāo)簽（用于將您的Flash應(yīng)用程序添加到網(wǎng)頁）的屬性來提供：直接用ActionScript代碼將您的客戶端ID和sensor參數(shù)作為Map對象的屬性提供：varmap:Map=newMap();map.sensor=false;map.client=gme-yourclientid;如果您使用FlashCS3開發(fā)應(yīng)用程序，則需要使用此方法。GoogleMapsAPI（Flash版）目前尚未啟用https。使用地圖API服務(wù)Google地圖API專業(yè)版客戶端I

15、D不僅可讓您訪問具有企業(yè)支持的JavaScriptAPI，而且還可訪問現(xiàn)有的任何Google地圖API服務(wù)。通過專業(yè)版許可使用這些服務(wù)可獲得更多訪問權(quán)限和支持。靜態(tài)地圖APIGoogle靜態(tài)地圖API可讓您使用通過其網(wǎng)址服務(wù)傳遞的參數(shù)構(gòu)造和檢索地圖圖像。有關(guān)Google靜態(tài)地圖API的完整文檔，請訪問HYPERLINK/apis/maps/documentation/staticmaps/t_blank/apis/maps/documentation/staticmaps/。使用專業(yè)版客戶端ID的靜態(tài)地圖API請求具有更高的查詢限制。要使用Google地圖API專業(yè)版客戶端ID在網(wǎng)頁中嵌入地圖

16、圖像，請將一個包含您的客戶端ID的client參數(shù)附加到靜態(tài)地圖網(wǎng)址，另請傳遞sensor參數(shù)值。/staticmap?center=40.714728,-73.998672&zoom=12&size=400 x400&client=gme-yourclientid&sensor=false請注意，您無需傳遞API密鑰。Google地圖API專業(yè)版客戶還可通過https向靜態(tài)地圖API提出請求。要通過https使用靜態(tài)地圖API，首先必須由Google企業(yè)支持允許您的客戶端ID啟用HTTPS訪問。要將地圖圖像嵌入到通過安全的https連接檢索的網(wǎng)頁，請在您的請求網(wǎng)址中使用備用主機(jī)名，如下所示：

17、/staticmap?center=40.714728,-73.998672&zoom=12&size=400 x400&client=gme-yourclientid&sensor=false注意：如果通過https使用尚未啟用https的客戶端ID進(jìn)行靜態(tài)地圖API請求，那么請求會遭拒絕，并發(fā)生狀態(tài)400“錯誤請求”錯誤。地址解析服務(wù)Google地圖地址解析服務(wù)可讓您請求經(jīng)度和緯度信息以進(jìn)行地址查詢。有關(guān)GoogleHTTP地址解析器的完整文檔，請訪問HYPERLINK/apis/maps/documentation/services.htmllGeocoding_Directt_blan

18、k/apis/maps/documentation/services.html#Geocoding_Direct。要使用Google地圖API專業(yè)版客戶端ID從Googlehttp地址解析器請求地址解析，請將一個包含您的客戶端ID的client參數(shù)附加到地址解析器網(wǎng)址。/maps/geo?q=1600+Amphitheatre+Parkway,+Mountain+View,+CA&output=xml&client=gme-yourclientid&sensor=false請注意，您無需在該網(wǎng)址中提供API密鑰，但必須提供sensor參數(shù)。Google地圖API專業(yè)版客戶還可通過https向地址解析服務(wù)提出請求。要通過https使用地址解析服務(wù)，首先必須由Google企業(yè)支持允許您的客戶端ID啟用HTTPS訪問。要通過