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

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

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

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

การแสดงรายการข้อผิดพลาด

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

required

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

notFound invalid

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

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

• สำหรับชิ้นส่วนแผนที่ปกติ พิกัด x จะต้องอยู่ในช่วง [0, (2^ซูม)-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 วินาที คุณจึงเผยแพร่ได้อย่างมีประสิทธิภาพ คำขอที่ต่อเนื่องแต่ละครั้งโดยเพิ่มระยะเวลาระหว่างคำขอเหล่านั้นเป็นสองเท่า

กระเบื้อง 3 มิติ

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

ข้อผิดพลาดเกี่ยวกับตัวแสดงผลการ์ด

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

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

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

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

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

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

403: สิทธิ์ถูกปฏิเสธ

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

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

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