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

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

ชิ้นส่วนแผนที่ 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 ที่ถูกต้อง

expired

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

badRequest

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

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

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

• คุณได้ส่งค่า lat/lng รวมถึงรหัสภาพพาโนรามาในคําขอข้อมูลเมตาของ 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 คุณควรลองส่งคำขออีกครั้ง เช่น เพื่อไม่ให้คำขอที่ไม่สมบูรณ์หรือความล้มเหลวในระดับวงกว้างมากจนไม่นับรวมเซิร์ฟเวอร์ Goodle เนื่องจากไคลเอ็นต์จำนวนมากจะพยายามส่งคำขออีกครั้งตามลำดับอย่างรวดเร็ว ซึ่งหมายความว่าจะใช้ Exponential Backoff เมื่อคุณส่งคำขออีกครั้ง Exponential Backoff จะบังคับให้คุณกระจายคำขอออกไปทันเวลาเพื่อให้เซิร์ฟเวอร์มีเวลาในการกู้คืน

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

ชิ้นส่วน 3 มิติ

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

ข้อผิดพลาดเกี่ยวกับโปรแกรมแสดงผลไทล์

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

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

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

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

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

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

403: ไม่ได้รับอนุญาต

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

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

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