跳转到主要内容
POST
Get 2D Map Tile

请求规范

  • 方法与路径: POST /apis/v1/google-maps/get2d-tile
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/google-maps/get2d-tile
  • Runtime 事实版本: 3b5a2acec503471a11eb19f2556b4dd51989d71bc63d22f67f55218e55b002ef
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

按用量计费;默认请求预估费用:$0.0009 USD(不是固定价格)。 声明的单位费率:每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.0009
  • 声明的单位费率(USD): 1e-06
  • 计费单位: provider_credit
  • 计费依据: response_units
  • 公开参考倍率: 1.0
  • 声明的最大计数或单位数: 10000000
  • 结算证据来源: response_body

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
x
integer
必填

Tile column coordinate. Valid range: [0, (2^zoom)-1].

必填范围: 0 <= x <= 4194303
y
integer
必填

Tile row coordinate. Valid range: [0, (2^(zoom-1))-1]. Valid range: [0, (2^zoom)-1], same as x.

必填范围: 0 <= x <= 4194303
z
integer
必填

Zoom level ranging from 0 (entire world) to 22 (highly detailed).

必填范围: 0 <= x <= 22
示例:

0

10

15

20

session
string
必填

Session token UUID obtained from /v1/createSession endpoint. Valid for approximately two weeks. Required for all 2D tile requests. Reuse across multiple tile requests; each createSession call consumes quota.

Minimum string length: 1
key
string

Google API key for authentication. If not provided, will be extracted from connection metadata. Required if not using Bearer token authentication.

示例:

"YOUR_API_KEY"

orientation
integer

Rotation parameter in degrees counter-clockwise. Valid values: 0, 90, 180, or 270.

示例:

0

90

180

270

响应

Tool result data

tile
object
必填