การจัดการข้อผิดพลาด

หลังจากส่งคำขอแล้ว คุณอาจได้รับการตอบกลับที่มีรายละเอียดข้อผิดพลาด

ชิ้นส่วน 2 มิติและภาพ Street View

รายการต่อไปนี้แสดงรายละเอียดข้อผิดพลาดที่คุณอาจพบเมื่อใช้ไทล์ 2 มิติ และภาพ Street View

เกิดข้อผิดพลาดในการแสดง

รายการต่อไปนี้แสดงรายละเอียดข้อผิดพลาดที่คุณอาจพบเมื่อใช้ Map Tiles API

required

คำขอของคุณไม่มีพารามิเตอร์ของ URL โปรดทราบว่าข้อความแสดงข้อผิดพลาดจะระบุ พารามิเตอร์ที่ขาดหายไป

notFound, invalid

ค่า x, y หรือ z อยู่นอกช่วง

• สำหรับไทล์แผนที่ปกติ ระดับการซูมสูงสุดจะขึ้นอยู่กับไทล์แผนที่ นั้นๆ และตัวเลือกแผนที่ที่คุณขอ

• สำหรับไทล์แผนที่ปกติ พิกัด x ต้องอยู่ในช่วง [0, (2^zoom)-1]

• สำหรับไทล์แผนที่ปกติ พิกัด y ต้องอยู่ในช่วง [0, (2^(zoom-1))-1]

• สำหรับไทล์ Street View ระดับการซูมต้องอยู่ระหว่าง 0 ถึง 5 เท่านั้น

• สำหรับไทล์ Street View ช่วงพิกัด x และ y จะเหมือนกับ ไทล์แผนที่ปกติจนถึงการซูมระดับ 5 ณ จุดนั้น ค่าสูงสุดคือ imageHeight หรือ imagewidth หารด้วย tileHeight หรือ tileWidth

forbidden:

สาเหตุที่เป็นไปได้:

• คำขอไม่มีคีย์ API ที่ถูกต้อง

• ข้อความ: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

  ไทล์ดาวเทียม 2 มิติไม่พร้อมใช้งานในโปรเจ็กต์ที่ลิงก์กับ บัญชีสำหรับการเรียกเก็บเงินที่มีที่อยู่ในเขตเศรษฐกิจยุโรป (EEA) ดูข้อมูลเพิ่มเติมได้ที่การปรับ Map Tiles API สำหรับลูกค้าใน EEA

expired

โทเค็น session ของคุณหมดอายุแล้ว โทเค็นเซสชันจะมีอายุ 2 สัปดาห์นับจากเวลาที่สร้าง โปรดทราบว่าข้อมูลนี้อาจเปลี่ยนแปลงได้ โดยไม่ต้องแจ้งให้ทราบ หากได้รับข้อผิดพลาดนี้ คุณต้องขอโทเค็นเซสชันใหม่ตามที่อธิบายไว้ในใช้โทเค็นเซสชัน

badRequest

คำขอของคุณมีรูปแบบไม่ถูกต้อง สาเหตุที่พบบ่อยมีดังนี้

• คุณระบุterrainประเภทแผนที่โดยไม่รวมเลเยอร์roadmap

• คุณใส่stylesอาร์เรย์สำหรับประเภทแผนที่ที่ไม่ใช่แผนที่เส้นทาง

• คุณส่งค่าละติจูด/ลองจิจูด รวมถึงรหัสพาโนรามาในคำขอข้อมูลเมตาของ Street View

quotaExceeded, rateLimitExceeded

แอปพลิเคชันของคุณมีโควต้าเกินที่อนุญาต หรือมีจำนวนการค้นหาต่อวินาทีเกินที่อนุญาต

ตัวอย่างข้อผิดพลาด

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

ลองส่งคำขออีกครั้ง

เมื่อคำขอไม่สำเร็จโดยมีข้อผิดพลาด quotaExceeded และ rateLimitExceeded คุณควรลองส่งคำขออีกครั้งในลักษณะที่คำขอที่เสียหรือความล้มเหลวในวงกว้างไม่ทำให้เซิร์ฟเวอร์ของ Google ทำงานหนักเกินไป เนื่องจากไคลเอ็นต์จำนวนมากพยายามส่งคำขออีกครั้งอย่างรวดเร็ว ซึ่งหมายถึงการใช้Exponential Backoff เมื่อลองส่งคำขออีกครั้ง Exponential Backoff บังคับให้คุณกระจายคำขอ ตามเวลาเพื่อให้เซิร์ฟเวอร์มีเวลาฟื้นตัว

เช่น หากคำขอไม่สำเร็จ ให้ลองอีกครั้งหลังจากผ่านไป 1 วินาที แต่หากความพยายามนั้นไม่สำเร็จเช่นกัน ให้ลองส่งคำขออีกครั้งหลังจากผ่านไป 2 วินาที หากคำขอดังกล่าวไม่สำเร็จ ให้ลองอีกครั้งหลังจากผ่านไป 4 วินาที ดังนั้นคุณจึงกระจาย คำขอแต่ละรายการที่ตามมาได้อย่างมีประสิทธิภาพเพียงแค่เพิ่มระยะเวลาระหว่างคำขอเป็น 2 เท่า

ชิ้นส่วนแผนที่ 3 มิติ

ข้อผิดพลาดจากเซิร์ฟเวอร์ของ Google อาจไม่ชัดเจนสำหรับคุณเนื่องจากคุณเข้าถึงไทล์สมจริงผ่านโปรแกรมแสดงผล ซึ่งมีหน้าที่จัดการข้อผิดพลาดของเซิร์ฟเวอร์

ข้อผิดพลาดของโปรแกรมแสดงผลไทล์

ตัวอย่างเช่น โดยปกติแล้วโปรแกรมแสดงผล CesiumJS จะล้มเหลวอย่างเงียบๆ เมื่อเกิดข้อผิดพลาดของเซิร์ฟเวอร์ ซึ่งอาจส่งผลให้เกิดปัญหาต่างๆ ตั้งแต่การขัดข้อง หน้าจอว่าง ไปจนถึงไทล์บางรายการไม่โหลด

เทคนิคที่คุณใช้ในการแก้ไขข้อบกพร่องของข้อผิดพลาดของเซิร์ฟเวอร์จะขึ้นอยู่กับโปรแกรมแสดงผลที่คุณใช้ สำหรับโปรแกรมแสดงผลที่ใช้เบราว์เซอร์ เช่น CesiumJS คุณสามารถตรวจสอบ การรับส่งข้อมูลเครือข่ายด้วยเครื่องมือที่มาพร้อมกับเบราว์เซอร์ส่วนใหญ่ เช่น คุณใช้เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome ได้

ข้อผิดพลาดที่พบบ่อย

รายการต่อไปนี้มีรายละเอียดเกี่ยวกับข้อผิดพลาดที่พบบ่อยที่สุดซึ่งคุณอาจพบ

400: อาร์กิวเมนต์ไม่ถูกต้อง

คีย์ API, พารามิเตอร์การค้นหา, รหัสไทล์/ชุดไทล์ หรือโทเค็นเซสชันที่หมดอายุไม่ถูกต้อง

400: ค่าไม่ถูกต้อง

ตรวจสอบว่า mapType ที่ใช้ในการส่งcreateSessionTokenคำขอ ตรงกับ mapType ที่ใช้ในปลายทางไทล์ที่ตามมา เช่น ใช้โทเค็นเซสชัน streetview ไม่ได้เพื่อขอไทล์ roadmap

403: ไม่อนุญาต

สาเหตุที่เป็นไปได้:

• ไม่มีคีย์ API, ไม่มีการเชื่อมต่อ SSL หรือไม่ได้เพิ่มคีย์ API ลงในรายการที่อนุญาตสำหรับ 3D Tiles ติดต่อทีมสนับสนุนของ Google พร้อมรหัสโปรเจ็กต์เพื่อขอเพิ่ม ในรายการที่อนุญาตสำหรับฟังก์ชันการทำงานของ 3D Tiles ใน Map Tiles API

• ข้อความ: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

  ชิ้นส่วนแผนที่ 3 มิติแบบสมจริงไม่พร้อมใช้งานในโปรเจ็กต์ที่ลิงก์กับ บัญชีสำหรับการเรียกเก็บเงินที่มีที่อยู่ในเขตเศรษฐกิจยุโรป (EEA) ดูข้อมูลเพิ่มเติมได้ที่การปรับ Map Tiles API สำหรับลูกค้าใน EEA

429: มีคำขอมากเกินไป

โควต้าของคุณหมดแล้ว ติดต่อทีมสนับสนุนของ Google เพื่อเพิ่มโควต้า