Method: resolveMapsUrls

แปลงรายการ URL ของ Google Maps เป็นเอนทิตีเชิงพื้นที่เฉพาะ (เช่น สถานที่) ใน Google Maps

คำขอ HTTP

POST https://mapstools.googleapis.com/v1alpha:resolveMapsUrls

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "urls": [
    string
  ]
}
ช่อง
urls[]

string

ต้องระบุ URL ของ Google Maps ที่จะแปลง URL แต่ละรายการควรเป็น URL ของ Google Maps ที่ถูกต้อง เช่น https://maps.app.goo.gl/..., https://www.google.com/maps/place/..., หรือ https://maps.google.com/... ปัจจุบันระบบรองรับเฉพาะ URL ที่ชี้ไปยังสถานที่เดียว คุณระบุ URL ได้สูงสุด 20 รายการ

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ v1alpha.resolveMapsUrls

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
ช่อง
entities[]

object (Entity)

เอาต์พุตเท่านั้น รายการเอนทิตีที่แปลงจาก URL ของ Google Maps ซึ่งรับประกันว่าจะมีการแมปแบบ 1:1 กับดัชนี urls ของคำขอ ข้อความว่างที่ดัชนี i (ซึ่งไม่มีการตั้งค่า entity) แสดงว่าการแปลง URL นั้นไม่สำเร็จ หากการแปลงไม่สำเร็จ โปรดตรวจสอบช่อง failedRequests เพื่อดูสถานะข้อผิดพลาด
failedRequests

map (key: integer, value: object (Status))

เอาต์พุตเท่านั้น แผนที่ที่สื่อสารความล้มเหลวบางส่วนสำหรับ URL ของ Google Maps โดยคีย์คือดัชนีของคำขอที่ไม่สำเร็จในช่อง urls ค่าคือสถานะข้อผิดพลาดที่ระบุรายละเอียดว่าเหตุใดการแปลงจึงไม่สำเร็จ

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/maps-platform.mapstools