静态地图api开发人员指南

《静态地图api开发人员指南》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、静态地图API开发人员指南欢迎阅读Google静态地图API的开发人员文档！通过Google静态地图API，您不需要使用JavaScript或加载任何动态页面，便可将Google地图图像嵌入到自己的网页中。Google静态地图服务会根据通过标准HTTP请求发送的网址参数来创建您的地图，并将地图以您可以在网页上显示的图像形式返回。Google静态地图API需要地图API密钥。如果尚未注册地图API密钥，请注册一个免费的API密钥。新！Google静态地图API现在具有卫星和地形图块功能！快速示例以下示例包含静态地图图像的网址，如下所示：#NotethatthisURLwr

2、apsatthe''character.#YoucancopytheURLfromtheimagebelow,however.#Forclarity,wedon'twritetheactualAPIkeyinuse.#http://ditu.google.cn/staticmap?center=40.714728,-73.998672&zoom=14&size=512x512&maptype=mobile&markers=39.949328,116.3875,blues%7C39.949328,116.3775,greeng%7C39.943028,116.3975

3、,redc&key=MAPS_API_KEY&sensor=false请注意，您无需进行任何“特殊”操作便可在地图上显示此图像。不需要JavaScript。只需创建一个网址并将其放入标签中。您可以将Google静态地图放在可放置图像的网页上的任何位置。目录1.受众2.使用限制3.概览4.网址参数5.参数的用法o指定位置§经度和纬度§地址解析42o缩放级别o图像大小o视口o图像格式o地图类型o添加标记§标记描述符§使用标记隐式定位地图o静态地图路径§路径属性§指定路径点2.更多信息读者本文档适用于希望在网页中包含Google静态地图API图像的网站和手机开发人

4、员。它对使用有关可用参数的API和参考材料进行了介绍。使用限制使用静态地图API需要注册一个免费的地图API密钥。地图API密钥允许您使用静态地图API和标准地图API。使用Google静态地图API还需遵从每位查看者每天的唯一（不同）图像请求不超过1000次的查询限制。由于此限制是按“查看者”而非“关键字”制订的配额，因此大多数开发人员并不需要为超过其配额而担心。此外，请注意，一般情况下，对相同图像的请求，除了第一次，其他请求并不计入该限制。如果用户超出以上的禁止限制，则将显示以下图像，指示超出了配额：强制执行此限制是为了防止滥用和/或重复使用静态地图API。以后可能

5、对此限制进行更改，而无需另行通知。如果超过了24小时的限制或滥用此服务，静态地图API会临时停止运行。如果您继续无视这个限制，将会阻止您对静态地图API的访问。42概述Google静态地图API通过网址返回图像（GIF、PNG或JPEG）来响应HTTP请求。您可以为每个请求指定地图的位置、图像的大小、缩放级别、地图的类型以及可选标记在地图各个位置上的放置。此外，您还可以使用字母字符为您的标记制作标签，以便在“关键字”中引用这些标记。将静态地图API图像嵌入标签的src属性内的网页上。当显示网页时，浏览器从静态地图API请求图像，并显示在图像位置内。本文档介绍了

6、静态地图API网址的所需格式和可用参数。还提供了一些指定网址的提示和技巧。网址参数Google静态地图API网址必须为以下形式：http://ditu.google.cn/staticmap?parameters有些参数是必需的，而有些参数则是可选的。根据HTTP请求的标准，所有参数均使用&(&)字符分隔。参数列表及参数的可能值枚举如下。静态地图API使用以下网址参数定义地图图像：·center（不显示标记时为必需）定义地图的中心，到地图各边缘的距离相等。此参数采用一个用逗号分隔的{经度,纬度}对（例如，"40.714728,-73.998672"）来标识地球表面的唯一

7、位置。有关详细信息，请参见下面的经度和纬度。·zoom（不显示标记时为必需）定义地图的缩放级别，缩放级别确定地图放大的级别。此参数根据所需的区域缩放级别来采用数字值。有关更多信息，请参见下面的缩放级别。·size（必需）定义地图图像的矩形尺寸。此参数采用valuexvalue形式的字符串，其中先表示水平像素，再表示垂直像素。例如，500x400定义了一幅宽为500像素、高为400像素的地图。如果您创建一幅宽为100像素或更小的静态地图，“由Google强力驱动”徽标的大小会自动缩小。·format（可选）定义生成的图像的格式。默认情况下，