Google 地图 API 专业版开发人员指南
Google 地图API 专业版开发人员指南
Google 地图API 可让您向自己的公共网站添加易于使用的交互式地图，通过帮助客户从您的组织中找到他们真正所需的内容来改善客户体验。这就是该API 成为全球最受欢迎的地图绘制API 的原因。当Google 地图在您的公共网站上起很重要的作用，或者已纳入到内部应用程序中以供您的员工使用时，组织需要一种企业级应用程序来处理大量工作并提供必要的支持。
1.为何要使用Google 地图API
专业版？
2.指定“客户端ID”
3.使用sensor参数跟踪使用情况
4.访问和加载API
1.使用client参数加载
JavaScript API
2.使用通用加载程序加载
JavaScript API
3.加载Google Maps API
（Flash 版）
5.使用地图API 服务
1.静态地图API
2.地址解析服务
6.支持
为何要使用Google 地图API 专业版？
Google 地图API 专业版可提供针对企业的应用程序支持，以满足您的地图绘制应用程序需求。Google 地图API 专业版所使用的代码库与标准Google 地图API 相同，但它还提供以下附加功能和优点：
?强大的服务级别协议(SLA)
?客户支持
?增加的地址解析限制
?商业级条款
?企业内的Intranet 应用程序支持
?通过安全的https连接对API
进行访问
Google 地图API 专业版要求先注册您的网站才能访问这些附加功能。有关详细信息，请联系我们。
本文档介绍了Google 地图API 专业版产品特定的使用案例和编码问题。有关所有通用代码的完整文档，请参考现有的Google 地图API 文档来使用本指南。
指定“客户端ID”
要访问Google 地图API 专业版的特殊功能，您必须在访问任何专业版API 库或服务时都提供“客户端ID”。当注册使用Google 地图API 专业版时，可从Google 企业支持处获得此“客户端ID”。所有客户端ID 都以gme-前缀开头。
您的客户端ID 可以与一个或多个网站域关联。对于现有客户而言，您以前通过发布API 密钥关联到您的专业版帐户的所有域都会自动添加至您的帐户。如果希望获得您当前启用的域的列表，或希望为您的客户端ID 启用其他域，请联系Google 企业支持。可为您的客户端ID 启用的域的数量不限。
注意：此客户端ID 不是密钥。它只在您授权的域起作用，因此您无需担心它的保密性。当Google 地图API 专业版用户使用该地图API 或它的某项服务时，不再需要进行注册或提供API 密钥。
使用sensor参数跟踪使用情况
现在，使用Google 地图API 时，需要指明您的应用程序在任何地图API 库或服务请求中是否使用传感器（例如GPS 定位器）确定用户的位置。这对移动设备尤为重要。如果Google 地图API 应用程序使用任何形式的传感器来确定访问您的应用程序的设备的位置，则必须通过将sensor参数值设置为true来声明这一点。
请注意，即使您的应用程序未使用任何位置传感器，仍需要设置sensor参数（在本例中设置为false）。
访问和加载API
将地图API 库或服务加载为专业版应用程序需要通过client参数指定客户端ID。指定该值的具体方式取决于您所使用的库或服务。
使用client参数加载JavaScript API
要使用您的Google 地图API 专业版客户端ID 加载Google 地图JavaScript API，需要将额外的client 参数附加到用来检索JavaScript 库的网址：
src="https://www.sodocs.net/doc/c71276354.html,/maps?file=api&v=2&client=gme-yourclientid& sensor=false" type="text/javascript"/> 请注意，您无需在该网址中提供API 密钥，但必须提供sensor参数。 Google 地图API 专业版客户还可以通过https访问Google 地图JavaScript API。要通过https使用Google 地图JavaScript API，首先必须由Google 企业支持允许您的客户端ID 启用HTTPS 访问。如果未允许您的客户端使用https，则请求将重定向到HTTP。 要通过https加载Google 地图JavaScript API，需要使用HTTPS 协议并从以下网址加载API： src="https://https://www.sodocs.net/doc/c71276354.html,/maps?file=api&v=2&client=gme-you rclientid&sensor=false" type="text/javascript"/> 使用通用加载程序加载JavaScript API Google 地图JavaScript API 现在已与Google AJAX API 完全集成，如 https://www.sodocs.net/doc/c71276354.html,/apis/maps/documentation/#AJAX_Loader中所述。 如果希望通过Google 地图API 专业版客户端ID 加载Google 地图JavaScript API，则加载通用加载程序时无需提供API 密钥： 使用通用加载程序加载Google 地图JavaScript API 时，需要通过other_params选项提供您的客户端ID： google.load("maps","2", {"other_params":"client=gme-yourclientid&sensor=false"}); Google 地图API 专业版客户还可以通过https加载Google 地图JavaScript API。要通过https使用Google 地图JavaScript API，首先必须由Google 企业支持允许您的客户端ID 启用HTTPS 访问。 要使用Google AJAX API 加载程序通过https加载Google 地图JavaScript API，请先通过https加载通用加载程序： 加载后，即可使用google.load()加载Google 地图JavaScript API（如上所示）。通过https提出Google 地图JavaScript API 的请求时，如果通过尚未允许启用https访问的客户端ID 使用通用加载程序加载地图API，则会重定向至HTTP。 加载Google Maps API（Flash 版） 您的Google 地图API 专业版客户端ID 还可让您以企业应用程序的形式访问Google Maps API（Flash 版）。有关Google Maps API（Flash 版）的完整文档，请访问https://www.sodocs.net/doc/c71276354.html,/apis/maps/documentation/flash/。与JavaScript API 一样，当您访问该API 时，虽然不需要提供API 密钥，但却需要传递client和sensor 参数。 注意：Google Maps API（Flash 版）可让使用不低于1.8b 版Flash SDK的专业版客户免去提供API 密钥的必要。请确保使用不低于1.8b 的版本编译您的应用程序，以利用无需提供密钥即可访问的功能。现有的应用程序需要用该版本重新编译，才能享受无需提供密钥的支持。 访问Google Maps API（Flash 版）时，可通过三种方式来提供您的Google 地图API 专业版客户端ID。无论选择哪种方式，都建议您用同一种方式提供您的客户端ID 和sensor参数： 1.将您的客户端ID 和sensor 参数作为在MXML 中声明的UI 容器对象的属性来提供： 2. xmlns:maps="com.google.ma ps.*" id="map" 3.mapevent_mapready="onMa pReady(event)" width="100%" height="100%" sensor="false" client="gme-yourclientid" /> 如果您使用FlexBuilder 或 Flex Framework 开发应用程 序，应首选此方法。 4.将您的客户端ID 和sensor 参数作为object和embed标 签（用于将您的Flash 应用程序 添加到网页）的属性来提供： 5. name="map_canvas"> 6. classid="clsid:D27CDB6E-A E6D-11cf-96B8-44455354000 0" 7. codebase="http:// https://www.sodocs.net/doc/c71276354.html,/p ub/shockwave/cabs/flash/s wflash.cab#version=6,0,29 ,0" 8. width="800px" 9. height="600px"> 10. value="helloworld.swf"> 11. name="quality" value="high"> 12. name="flashVars" value="client=gme-yourcli entid&sensor=false"> 13. width="800px" 14. height="600px" 15. src="helloworld .swf" 16. quality="high" 17. flashVars="clie nt=gme-yourclientid&senso r=false" 18. pluginspage="ht tp://https://www.sodocs.net/doc/c71276354.html,/g o/getflashplayer" 19. type="applicati on/x-shockwave-flash"> 20. 21. 22.直接用ActionScript 代 码将您的客户端ID 和sensor 参数作为Map对象的属性提供： 23. var map:Map = new Map(); 24. map.sensor = false; map.client = "gme-yourclientid"; 如果您使用Flash CS3 开发应 用程序，则需要使用此方法。Google Maps API（Flash 版）目前尚未启用https。 使用地图API 服务 Google 地图API 专业版客户端ID 不仅可让您访问具有企业支持的JavaScript API，而且还可访问现有的任何Google 地图API 服务。通过专业版许可使用这些服务可获得更多访问权限和支持。 静态地图API Google 静态地图API 可让您使用通过其网址服务传递的参数构造和检索地图图像。有关Google 静态地图API 的完整文档，请访问 https://www.sodocs.net/doc/c71276354.html,/apis/maps/documentation/staticmaps/。使用专业版客户端ID 的静态地图API 请求具有更高的查询限制。 要使用Google 地图API 专业版客户端ID 在网页中嵌入地图图像，请将一个包含您的客户端ID 的client参数附加到静态地图网址，另请传递sensor参数值。 https://www.sodocs.net/doc/c71276354.html,/staticmap?center=40.714728,-73.998672&zoom=12&s ize=400x400&client=gme-yourclientid&sensor=false 请注意，您无需传递API 密钥。 Google 地图API 专业版客户还可通过https向静态地图API 提出请求。要通过https使用静态地图API，首先必须由Google 企业支持允许您的客户端ID 启用HTTPS 访问。 要将地图图像嵌入到通过安全的https连接检索的网页，请在您的请求网址中使用备用主机名，如下所示： https://https://www.sodocs.net/doc/c71276354.html,/staticmap?center=40.714728,-73.998672 &zoom=12&size=400x400&client=gme-yourclientid&sensor=false 注意：如果通过https使用尚未启用https的客户端ID 进行静态地图API 请求，那么请求会遭拒绝，并发生状态400“错误请求”错误。 地址解析服务 Google 地图地址解析服务可让您请求经度和纬度信息以进行地址查询。有关Google HTTP 地址解析器的完整文档，请访问 https://www.sodocs.net/doc/c71276354.html,/apis/maps/documentation/services.html#Geocoding_ Direct。 要使用Google 地图API 专业版客户端ID 从Google http 地址解析器请求地址解析，请将一个包含您的客户端ID 的client参数附加到地址解析器网址。 https://www.sodocs.net/doc/c71276354.html,/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 访问。 要通过https使用Google HTTP 地址解析器请求地址解析，请在您的请求网址中使用备用主机名，如下所示： https://https://www.sodocs.net/doc/c71276354.html,/maps/geo?q=1600+Amphitheatre+Parkway, +Mountain+View,+CA&output=xml&client=gme-yourclientid&sensor=false 如果通过https使用尚未启用https的客户端ID 向地图API 地址解析服务提出请求，会返回610 (G_GEO_BAD_KEY) 地址解析器响应。如果提出的请求超出您的日常吞吐量限制和即时吞吐量限制，可能会返回620 (G_GEO_TOO_MANY_QUERIES)。