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

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

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

ชิ้นส่วนแผนที่ 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 สำหรับประเภทแผนที่ที่ไม่ใช่ `roadmap`

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

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

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