Google地图API专业版开发人员指南讲课教案

1、Good is good, but better carries it.精益求精，善益求善。Google地图API专业版开发人员指南Google地图API专业版开发人员指南Google地图API可让您向自己的公共网站添加易于使用的交互式地图，通过帮助客户从您的组织中找到他们真正所需的内容来改善客户体验。这就是该API成为全球最受欢迎的地图绘制API的原因。当Google地图在您的公共网站上起很重要的作用，或者已纳入到内部应用程序中以供您的员工使用时，组织需要一种企业级应用程序来处理大量工作并提供必要的支持。HYPERLINK/intl/zh-CN/apis/maps/documentation

2、/premier/guide.htmllWhyPremiert_blank为何要使用Google地图API专业版？HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllSignupt_blank指定“客户端ID”HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllSensort_blank使用sensor参数跟踪使用情况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参数加载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服务HYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllStaticMapst_blank静态地图APIHYPERLINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllGeocodingt_blank地址解析服务HYPER

5、LINK/intl/zh-CN/apis/maps/documentation/premier/guide.htmllSupportt_blank支持为何要使用Google地图API专业版？Google地图API专业版可提供针对企业的应用程序支持，以满足您的地图绘制应用程序需求。Google地图API专业版所使用的代码库与标准Google地图API相同，但它还提供以下附加功能和优点：强大的服务级别协议(SLA)客户支持增加的地址解析限制商业级条款企业内的Intranet应用程序支持通过安全的https连接对API进行访问Google地图API专业版要求先注册您的网站才能访问这些附加功能。有关详

6、细信息，请HYPERLINK/enterprise/gmet_blank联系我们。本文档介绍了Google地图API专业版产品特定的使用案例和编码问题。有关所有通用代码的完整文档，请参考现有的HYPERLINK/apis/maps/documentation/t_blankGoogle地图API文档来使用本指南。指定“客户端ID”要访问Google地图API专业版的特殊功能，您必须在访问任何专业版API库或服务时都提供“客户端ID”。当注册使用Google地图API专业版时，可从Google企业支持处获得此“客户端ID”。所有客户端ID都以gme-前缀开头。您的客户端ID可以与一个或多个网站域

7、关联。对于现有客户而言，您以前通过发布API密钥关联到您的专业版帐户的所有域都会自动添加至您的帐户。如果希望获得您当前启用的域的列表，或希望为您的客户端ID启用其他域，请联系Google企业支持。可为您的客户端ID启用的域的数量不限。注意：此客户端ID不是密钥。它只在您授权的域起作用，因此您无需担心它的保密性。当Google地图API专业版用户使用该地图API或它的某项服务时，不再需要进行注册或提供API密钥。使用sensor参数跟踪使用情况现在，使用Google地图API时，需要指明您的应用程序在任何地图API库或服务请求中是否使用传感器（例如GPS定位器）确定用户的位置。这对移动设备尤为重

8、要。如果Google地图API应用程序使用任何形式的传感器来确定访问您的应用程序的设备的位置，则必须通过将sensor参数值设置为true来声明这一点。请注意，即使您的应用程序未使用任何位置传感器，仍需要设置sensor参数（在本例中设置为false）。访问和加载API将地图API库或服务加载为专业版应用程序需要通过client参数指定客户端ID。指定该值的具体方式取决于您所使用的库或服务。使用client参数加载JavaScriptAPI要使用您的Google地图API专业版客户端ID加载Google地图JavaScriptAPI，需要将额外的client参数附加到用来检索JavaScrip

9、t库的网址：请注意，您无需在该网址中提供API密钥，但必须提供sensor参数。Google地图API专业版客户还可以通过https访问Google地图JavaScriptAPI。要通过https使用Google地图JavaScriptAPI，首先必须由Google企业支持允许您的客户端ID启用HTTPS访问。如果未允许您的客户端使用https，则请求将重定向到HTTP。要通过https加载Google地图JavaScriptAPI，需要使用HTTPS协议并从以下网址加载API：使用通用加载程序加载JavaScriptAPIGoogle地图JavaScriptAPI现在已与GoogleAJAX

10、API完全集成，如HYPERLINK/apis/maps/documentation/lAJAX_Loadert_blank/apis/maps/documentation/#AJAX_Loader中所述。如果希望通过Google地图API专业版客户端ID加载Google地图JavaScriptAPI，则加载通用加载程序时无需提供API密钥：使用通用加载程序加载Google地图JavaScriptAPI时，需要通过other_params选项提供您的客户端ID：google.load(maps,2,other_params:client=gme-yourclientid&sensor=fals

11、e);Google地图API专业版客户还可以通过https加载Google地图JavaScriptAPI。要通过https使用Google地图JavaScriptAPI，首先必须由Google企业支持允许您的客户端ID启用HTTPS访问。要使用GoogleAJAXAPI加载程序通过https加载Google地图JavaScriptAPI，请先通过https加载通用加载程序：加载后，即可使用google.load()加载Google地图JavaScriptAPI（如上所示）。通过https提出Google地图JavaScriptAPI的请求时，如果通过尚未允许启用https访问的客户端ID使用通

12、用加载程序加载地图API，则会重定向至HTTP。加载GoogleMapsAPI（Flash版）您的Google地图API专业版客户端ID还可让您以企业应用程序的形式访问GoogleMapsAPI（Flash版）。有关GoogleMapsAPI（Flash版）的完整文档，请访问HYPERLINK/apis/maps/documentation/flash/t_blank/apis/maps/documentation/flash/。与JavaScriptAPI一样，当您访问该API时，虽然不需要提供API密钥，但却需要传递client和sensor参数。注意：GoogleMapsAPI（Flas

13、h版）可让使用不低于1.8b版HYPERLINK/maps/flash/release/sdk.zipt_blankFlashSDK的专业版客户免去提供API密钥的必要。请确保使用不低于1.8b的版本编译您的应用程序，以利用无需提供密钥即可访问的功能。现有的应用程序需要用该版本重新编译，才能享受无需提供密钥的支持。访问GoogleMapsAPI（Flash版）时，可通过三种方式来提供您的Google地图API专业版客户端ID。无论选择哪种方式，都建议您用同一种方式提供您的客户端ID和sensor参数：将您的客户端ID和sensor参数作为在MXML中声明的UI容器对象的属性来提供：如果您使用F

14、lexBuilder或FlexFramework开发应用程序，应首选此方法。将您的客户端ID和sensor参数作为object和embed标签（用于将您的Flash应用程序添加到网页）的属性来提供：直接用ActionScript代码将您的客户端ID和sensor参数作为Map对象的属性提供：varmap:Map=newMap();map.sensor=false;map.client=gme-yourclientid;如果您使用FlashCS3开发应用程序，则需要使用此方法。GoogleMapsAPI（Flash版）目前尚未启用https。使用地图API服务Google地图API专业版客户端I

15、D不仅可让您访问具有企业支持的JavaScriptAPI，而且还可访问现有的任何Google地图API服务。通过专业版许可使用这些服务可获得更多访问权限和支持。静态地图APIGoogle静态地图API可让您使用通过其网址服务传递的参数构造和检索地图图像。有关Google静态地图API的完整文档，请访问HYPERLINK/apis/maps/documentation/staticmaps/t_blank/apis/maps/documentation/staticmaps/。使用专业版客户端ID的静态地图API请求具有更高的查询限制。要使用Google地图API专业版客户端ID在网页中嵌入地图

16、图像，请将一个包含您的客户端ID的client参数附加到静态地图网址，另请传递sensor参数值。/staticmap?center=40.714728,-73.998672&zoom=12&size=400 x400&client=gme-yourclientid&sensor=false请注意，您无需传递API密钥。Google地图API专业版客户还可通过https向静态地图API提出请求。要通过https使用静态地图API，首先必须由Google企业支持允许您的客户端ID启用HTTPS访问。要将地图图像嵌入到通过安全的https连接检索的网页，请在您的请求网址中使用备用主机名，如下所示：

17、/staticmap?center=40.714728,-73.998672&zoom=12&size=400 x400&client=gme-yourclientid&sensor=false注意：如果通过https使用尚未启用https的客户端ID进行静态地图API请求，那么请求会遭拒绝，并发生状态400“错误请求”错误。地址解析服务Google地图地址解析服务可让您请求经度和纬度信息以进行地址查询。有关GoogleHTTP地址解析器的完整文档，请访问HYPERLINK/apis/maps/documentation/services.htmllGeocoding_Directt_blan

18、k/apis/maps/documentation/services.html#Geocoding_Direct。要使用Google地图API专业版客户端ID从Googlehttp地址解析器请求地址解析，请将一个包含您的客户端ID的client参数附加到地址解析器网址。/maps/geo?q=1600+Amphitheatre+Parkway,+Mountain+View,+CA&output=xml&client=gme-yourclientid&sensor=false请注意，您无需在该网址中提供API密钥，但必须提供sensor参数。Google地图API专业版客户还可通过https向地址解析服务提出请求。要通过https使用地址解析服务，首先必须由Google企业支持允许您的客户端ID启用HTTPS访问。要通过