Method: resolveMapsUrls

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

คำขอ HTTP

POST https://mapstools.googleapis.com/v1: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 รายการ

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

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

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

การแสดง JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
ช่อง
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" }
saveToMapsUrl

string

เอาต์พุตเท่านั้น ลิงก์สำหรับบันทึกเอนทิตีที่แก้ไขสำเร็จทั้งหมดใน Google Maps

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

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

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