静态地图 API 开发人员指南

静态地图API开发人员指南欢迎阅读Google静态地图API的开发人员文档！通过Google静态地图API，您不需要使用JavaScript或加载任何动态页面，便可将Google地图图像嵌入到自己的网页中。Google静态地图服务会根据通过标准HTTP请求发送的网址参数来创建您的地图，并将地图以您可以在网页上显示的图像形式返回。Google静态地图API需要地图API密钥。如果尚未注册地图API密钥，请注册一个免费的API密钥。新！Google静态地图API现在具有卫星和地形图块功能！快速示例以下示例包含静态地图图像的网址，如下所示：#NotethatthisURLwrapsatthe'\'character.#YoucancopytheURLfromtheimagebelow,however.#Forclarity,wedon'twritetheactualAPIkeyinuse.#=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,redc\&key=MAPS_API_KEY&sensor=false请注意，您无需进行任何“特殊”操作便可在地图上显示此图像。不需要JavaScript。只需创建一个网址并将其放入img标签中。您可以将Google静态地图放在可放置图像的网页上的任何位置。目录1.受众2.使用限制3.概览4.网址参数5.参数的用法o指定位置经度和纬度地址解析o缩放级别o图像大小o视口o图像格式o地图类型o添加标记标记描述符使用标记隐式定位地图o静态地图路径路径属性指定路径点6.更多信息读者本文档适用于希望在网页中包含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请求的标准，所有参数均使用&(&)字符分隔。参数列表及参数的可能值枚举如下。静态地图API使用以下网址参数定义地图图像：center（不显示标记时为必需）定义地图的中心，到地图各边缘的距离相等。此参数采用一个用逗号分隔的{经度,纬度}对（例如，40.714728,-73.998672）来标识地球表面的唯一位置。有关详细信息，请参见下面的经度和纬度。zoom（不显示标记时为必需）定义地图的缩放级别，缩放级别确定地图放大的级别。此参数根据所需的区域缩放级别来采用数字值。有关更多信息，请参见下面的缩放级别。size（必需）定义地图图像的矩形尺寸。此参数采用valuexvalue形式的字符串，其中先表示水平像素，再表示垂直像素。例如，500x400定义了一幅宽为500像素、高为400像素的地图。如果您创建一幅宽为100像素或更小的静态地图，“由Google强力驱动”徽标的大小会自动缩小。format（可选）定义生成的图像的格式。默认情况下，静态地图API创建GIF图像。有若干种可能的格式，包括GIF、JPEG和PNG类型。使用哪种格式取决于您想要显示图像的方式。JPEG通常提供更大程度的压缩，而GIF和PNG提供更多细节。有关详细信息，请参见图像格式。maptype（可选）定义要构造的地图类型。有若干种可能的地图类型值，包括satellite、terrain、hybrid和mobile。有关更多信息，请参见下面的静态地图API地图类型。markers（可选）定义要在指定位置附加到图像的一个或多个标记。此参数采用由管道字符(|)分隔的标记定义的字符串。请注意，如果为地图提供标记，就无需指定（通常情况下必需的）center和zoom参数。有关更多信息，请参见下面的静态地图标记。path（可选）定义要在指定位置覆盖在图像上的单条路径，其由两个或两个以上的连接点组成。此参数采用由管道字符(|)分隔的点定义的字符串。请注意，如果为地图提供标记，就无需指定（通常情况下必需的）center和zoom参数。有关详细信息，请参见下面的静态地图路径。span（可选）定义地图图像的最小“视口”，以成对的纬度和经度表示。静态地图服务采用该值并生成适当缩放级别的地图，以包含距地图中心点的所提供全部的span值。请注意，生成的地图可能包含在经度或纬度上更大的边界，这取决于地图的矩形尺寸。如果指定了zoom，则会忽略span。frame（可选）指定生成的图像应由蓝色的边框框起来。框架由5像素宽，不透明度为55%的蓝色边框组成。hl（可选）定义用于在地图图块上显示标签的语言。请注意，该参数仅支持部分国家/地区图块；如果请求的指定语言不支持图块集，则将为该图块集使用默认的语言。key（必需）标识生成此网址请求的域的地图API密钥。如果没有地图API密钥，可以注册一个免费的地图API密钥。sensor（必需）指定请求静态地图的应用程序是否使用传感器来确定用户的位置。对于所有静态地图请求，此参数都是必需的。有关详细信息，请参见下面的传感器。参数的用法静态地图API相对来说易于使用，因为它只包含一个参数网址。此部分介绍怎样使用这些参数构造您的网址。指定位置静态地图API必须能够精确标识地图上的位置，目的在于使地图处于正确的位置（使用center参数）和/或将任何可选地标放置到地图的各个位置上（使用·markers·参数）。静态地图API使用经纬度值指定这些位置。这些值共同标识“地址解析”位置。如果您的设备使用“传感器”（例如GPS设备）来确定某个设备或用户的位置，您还必须在您的静态地图API请求网址内传递sensor=true。如果您的应用程序不使用传感器，则传递sensor=false。经度和纬度使用逗号分隔的文本字符串内的数字定义经度和纬度，精确到6位小数。例如，“40.714728，-73.998672”是有效的地址解析值。精确到6位小数之后的部分将被忽略。经度值基于其到英国格林威治（本初子午线所在地）的距离。由于格林威治位于纬度51.477222，我们可以输入center值51.477222,0来使地图以格林威治为中心：经纬度值必须与地球表面的有效位置对应。纬度可以采用-90和90之间的任意值，而经度值则可采用-180和180之间的任意值。如果指定了无效的纬度或经度值，您的请求将作为错误请求被拒绝。地址解析许多人不使用经度和纬度，而是使用“地址”来表示位置。将地址转换为地理点的过程称为“地址解析”，将在Google地图API服务部分中详细讨论。请注意，要直接使用地址解析服务，需要使用地图API密钥。除了这个地址解析服务之外，您也可以使用其他服务（包括Google地图本身）来获取经地址解析后的经纬度值。例如，您可以将某个地址输入到Google地图，并通过单击地图右上方的链接到该页面来确定其经地址解析后的位置。将显示一个弹出式对话框，对话框内可复制的网址。如果将该网址复制到浏览器中，您便可以查找ll参数中包含的地址解析值。缩放级别Google地图上的地图具有整数“缩放级别”，可定义当前视图的分辨率。普通地图视图中，可以使用0（最低缩放级别，在地图上可以看到整个世界）到19（最高缩放级别，可以看到每个建筑物）之间的缩放级别。Google地图将缩放级别0设为包含整个地球。随后的每个缩放级别在水平和垂直尺寸上使精确度加倍。Google地图API文档中提供了有关怎样执行此操作的详细信息。注意：并非地球上的所有位置都会显示所有的缩放级别。缩放级别根据位置的不同而有所不同，因为地球上某些地区的数据与其他地区相比更加细化。如果发送了并不存在任何地图图块的缩放级别请求，静态地图API将转而返回黑色图像。下面的示例请求了两幅曼哈顿地图，center值相同，但缩放级别分别为12和14：=40.714728,-73.998672&zoom=12&size=400x400&key=MAPS_API_KEY&sensor=true_or_false=40.714728,-73.998672&zoom=14&size=400x400&key=MAPS_API_KEY&sensor=true_or_false图像大小可以检索的最大图像大小为640x640像素。size参数采用具有两个值的字符串，这两个值由x字符分隔。640x640是所允许的最大图像大小。请注意，center参数与size参数相结合可隐式定义地图图像的覆盖区域。下面的示例请求地球赤道上的某个“块”（缩放级别为1）：=0,0&zoom=1&size=400x50&key=MAPS_API_KEY&sensor=true_or_false以下示例请求100x100像素大小的小型地图，以相同的区域为中心。请注意较小的Google徽标：视口图像可能通过传递span参数指定一个“视口”（按纬度和经度值定义，以度为单位）来显示提供的中心点周围的地区。以这种方式定义最大视口免去了指定确切缩放级别的必要。静态地图服务将span参数与size参数配合使用来构建适当缩放级别的地图，其中至少包括指定的视口限制。以下示例请求一个方形地图，以0度经度和0度纬度为中心，宽度和高度为20度：=0,0&span=20,20&size=512x512&key=MAPS_API_KEY&sensor=true_or_false以下示例请求一个以曼哈顿为中心的地图，在两个方向显示1度的弧度。请注意，因为该地图水平形成，在水平方向扩展4度，因此可以在垂直方向最少扩展1度。=40.714728,-73.998672&span=1,1&size=512x128&key=MAPS_API_KEY&sensor=true_or_false图像格式可以以若干种常见网络图形格式返回图像：GIF、