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

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

ชิ้นส่วน 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 สำหรับประเภทแผนที่ที่ไม่ใช่แผนกลยุทธ์

• คุณส่งค่าละติจูด/ลองจิจูด รวมถึงรหัสพาโนรามาในคําขอข้อมูลเมตาของ 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 เพื่อขอเพิ่มโควต้า