静态地图 API 开发人员指南.docx

静态地图API开发人员指南欢迎阅读Google静态地图API的开发人员文档！通过Google静态地图API您不需要使用JavaScript或加载任何动态页面便可将Google地图图像嵌入到自己的网页中。Google静态地图服务会根据通过标准HTTP请求发送的网址参数来创建您的地图并将地图以您可以在网页上显示的图像形式返回。Google静态地图API需要地图API密钥。如果尚未注册地图API密钥请注册一个免费的API密钥。新！Google静态地图API现在具有卫星和地形图块功能！快速示例以下示例包含静态地图图像的网址如下所示：#NotethatthisURLwrapsatthe'\'character.#YoucancopytheURLfromtheimagebelowhowever.#Forclaritywedon'twritetheactualAPIkeyinuse.#http://ditu.google.cn/staticmap?center=40.714728-73.998672&zoom=14&size=512x512&maptype=mobile\&markers=39.949328116.3875blues%7C39.949328116.3775greeng%7C39.943028116.3975redc\&key=MAPS_API_KEY&sensor=false请注意您无需进行任何“特殊”操作便可在地图上显示此图像。不需要JavaScript。只需创建一个网址并将其放入<img>标签中。您可以将Google静态地图放在可放置图像的网页上的任何位置。目录受众使用限制概览网址参数参数的用法指定位置经度和纬度地址解析缩放级别图像大小视口图像格式地图类型添加标记标记描述符使用标记隐式定位地图静态地图路径路径属性指定路径点更多信息读者本文档适用于希望在网页中包含Google静态地图API图像的网站和手机开发人员。它对使用有关可用参数的API和参考材料进行了介绍。使用限制使用静态地图API需要注册一个免费的地图API密钥。地图API密钥允许您使用静态地图API和标准地图API。使用Google静态地图API还需遵从每位查看者每天的唯一（不同）图像请求不超过1000次的查询限制。由于此限制是按“查看者”而非“关键字”制订的配额因此大多数开发人员并不需要为超过其配额而担心。此外请注意一般情况下对相同图像的请求除了第一次其他请求并不计入该限制。如果用户超出以上的禁止限制则将显示以下图像指示超出了配额：强制执行此限制是为了防止滥用和/或重复使用静态地图API。以后可能对此限制进行更改而无需另行通知。如果超过了24小时的限制或滥用此服务静态地图API会临时停止运行。如果您继续无视这个限制将会阻止您对静态地图API的访问。概述Google静态地图API通过网址返回图像（GIF、PNG或JPEG）来响应HTTP请求。您可以为每个请求指定地图的位置、图像的大小、缩放级别、地图的类型以及可选标记在地图各个位置上的放置。此外您还可以使用字母字符为您的标记制作标签以便在“关键字”中引用这些标记。将静态地图API图像嵌入<img>标签的src属性内的网页上。当显示网页时浏览器从静态地图API请求图像并显示在图像位置内。本文档介绍了静态地图API网址的所需格式和可用参数。还提供了一些指定网址的提示和技巧。网址参数Google静态地图API网址必须为以下形式：http://ditu.google.cn/staticmap?parameters有些参数是必需的而有些参数则是可选的。根据HTTP请求的标准所有参数均使用&(&)字符分隔。参数列表及参数的可能值枚举如下。静态地图API使用以下网址参数定义地图图像：center（不显示标记时为必需）定义地图的中心到地图各边缘的距离相等。此参数采用一个用逗号分隔的{经度纬度}对（例如"40.714728-73.998672"）来标识地球表面的唯一位置。有关详细信息请参见下面的经度和纬度。zoom（不显示标记时为必需）定义地图的缩放级别缩放级别确定地图放大的级别。此参数根据所需的区域缩放级别来采用数字值。有关更多信息请参见下面的缩放级别。size（必需）定义地图图像的矩形尺寸。此参数采用valuexvalue形式的字符串其中先表示水平像素再表示垂直像素。例如500x400定义了一幅宽为500像素、高为400像素的地图。如果您创建一幅宽为100像素或更小