iFrame API

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

ก่อนเริ่ม#

• คีย์ API จริง ที่มีสิทธิ์ แผนที่ที่ฝัง ดู คีย์ API
• โปรเจกต์ที่ผู้เข้าชมดูได้: ของคุณหรือของบัญชีอื่น ที่แชร์เป็น visibilityดูเท่านั้น หรือ publicสาธารณะ โปรเจกต์ lockส่วนตัว จะแสดง เฉพาะเมื่อเป็นของบัญชีอื่นและเจ้าของได้อนุญาตคุณแล้ว (ดู โปรเจกต์ส่วนตัวของลูกค้า) โปรเจกต์ส่วนตัว ของคุณเองจะไม่แสดงเลย ดู โปรเจกต์ใดฝังได้บ้าง
• หากต้องการ การจำกัดเว็บไซต์ บนคีย์ เพื่อให้แผนที่ฝังทำงานเฉพาะบน เว็บไซต์ของคุณเอง ดู คีย์ API

สร้างโค้ดฝัง#

codeนักพัฒนา > web_assetฝังแผนที่ สร้างโค้ดให้คุณด้วยคีย์จริงของคุณ: เลือกโปรเจกต์ เลือกธีม หน่วย ประเภทแผนที่ และขนาด ตรวจสอบ**ตัวอย่างสด** และคัดลอก โค้ดฝัง หากโปรเจกต์เป็นส่วนตัว ส่วนนี้จะบอกและเสนอ visibilityตั้งเป็นดูได้อย่างเดียว ดู รับโค้ดฝัง สำหรับแต่ละขั้นตอน

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

ที่อยู่ของแผนที่ฝัง#

แผนที่ฝังคือ <iframe> ที่ที่อยู่ขึ้นต้นด้วย https://app.measuremaponline.com/iframe_api ตามด้วยพารามิเตอร์เหล่านี้:

ตัวอย่างขั้นต่ำ#

<iframe src="https://app.measuremaponline.com/iframe_api?pid=YOUR_PROJECT_ID&key=YOUR_API_KEY&maptype=satellite&theme=auto"
  title="YOUR_PROJECT_NAME" width="500" height="500" style="border:0" allow="fullscreen"></iframe>

แทนที่ YOUR_PROJECT_ID, YOUR_API_KEY และ YOUR_PROJECT_NAME (โปรแกรมอ่าน หน้าจอจะอ่าน title ออกเสียง) และตั้งความกว้างและความสูงให้เหมาะกับหน้าของคุณ

คีย์หรือโทเค็น#

เมื่อใช้ key ตามโค้ดที่ส่วน web_assetฝังแผนที่ ให้คุณ แผนที่ฝัง จะใช้ได้ตราบใดที่คีย์ยังใช้ได้ บนเว็บไซต์ที่การจำกัดของคีย์อนุญาต คีย์ของคุณ จะมองเห็นได้ในซอร์สของหน้าคุณ ดังนั้น:

• ใช้คีย์ที่มีสิทธิ์ แผนที่ที่ฝัง เท่านั้น
• จำกัดให้ใช้ได้กับเว็บไซต์ของคุณเองเท่านั้น
• เมื่อคุณเปลี่ยนคีย์ ให้อัปเดตหน้าของคุณภายใน 24 ชั่วโมงที่คีย์เก่ายังใช้ได้ (คีย์ที่สร้างก่อนมีการตั้งค่าสิทธิ์จะใช้ได้ถึงวันที่ที่แจ้งให้คุณทราบ)

เมื่อใช้ token คีย์จะอยู่บนเซิร์ฟเวอร์ของคุณ วิธีนี้เหมาะกับแผนที่ฝังที่ เซิร์ฟเวอร์ของคุณเองเขียนลงในหน้าสำหรับการเข้าชมแต่ละครั้ง: ก่อนแสดงหน้า เซิร์ฟเวอร์ขอโทเค็นจาก REST API และใส่ไว้ในที่อยู่ของ iframe:

• POST https://api.measuremaponline.com/api/v2/auth/iframe/token พร้อมคีย์ของคุณ ในส่วนหัว Authorization จะส่งคืน token ที่ใช้ได้ 60 นาที
• POST https://api.measuremaponline.com/api/v2/auth/token ทำเช่นเดียวกัน และรับ duration เป็นวินาที ได้สูงสุด 24 ชั่วโมง คำตอบจะบอกว่าโทเค็นหมดอายุเมื่อใด

บัญชีของคุณขอโทเค็นได้สูงสุด 600 รายการต่อชั่วโมง ใช้คีย์จริง: แผนที่ฝังแสดง เฉพาะโปรเจกต์จริง ดังนั้นโทเค็นที่สร้างด้วยคีย์ sandbox จะเปิดแผนที่ไม่ได้ ดูเอกสารอ้างอิง API

สิ่งที่ผู้เข้าชมทำได้#

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

เมื่อแผนที่ไม่ปรากฏ#

ในกรณีส่วนใหญ่แผนที่จะแสดงข้อความบอกสาเหตุ: ดู เมื่อแผนที่แสดงข้อความ ตรวจสอบตามลำดับ:

• ที่อยู่มี token ที่หมดอายุแล้ว โทเค็นมีอายุ 60 นาที เว้นแต่เซิร์ฟเวอร์ของคุณ ขอนานกว่านั้น คัดลอกโค้ดอีกครั้งจาก web_assetฝังแผนที่ ซึ่งใช้คีย์ของคุณ หรือให้เซิร์ฟเวอร์ของคุณขอ โทเค็นใหม่สำหรับการเข้าชมแต่ละครั้ง (ดูด้านบน)
• โปรเจกต์เป็นส่วนตัว หากเป็นของคุณ ให้ตั้งเป็น visibilityดูเท่านั้น หรือ publicสาธารณะ หรือกด visibilityตั้งเป็นดูได้อย่างเดียว ใน web_assetฝังแผนที่ หากเป็นของลูกค้า พวกเขาอนุญาตคุณได้ จากแผนที่ หรือคุณขอพวกเขาได้ใน โปรเจกต์ส่วนตัว
• แผนของโปรเจกต์สิ้นสุดแล้ว: แผนของเจ้าของ หรือสำหรับโปรเจกต์ขององค์กร คือแผนขององค์กร โปรเจกต์จะแสดงอีกครั้งเมื่อต่ออายุแผน
• เว็บไซต์ไม่ได้รับอนุญาต หากคีย์มีการจำกัดเว็บไซต์ หน้าที่แสดงแผนที่ฝัง ต้องอยู่บนเว็บไซต์ใดเว็บไซต์หนึ่งในรายการ เบราว์เซอร์และเว็บไซต์บางแห่ง ซ่อนว่าแผนที่ฝังอยู่ในหน้าใด เมื่อตั้งการจำกัดไว้ แผนที่ฝังเช่นนั้นจะถูกปฏิเสธ
• คีย์ถูกเปลี่ยนแล้ว คีย์เก่าหยุดทำงาน 24 ชั่วโมงหลังสร้างคีย์ใหม่ หรือทันทีหากถูกเพิกถอน
• คีย์เป็นคีย์ sandbox แผนที่ฝังใช้ได้กับคีย์จริงและโปรเจกต์จริงเท่านั้น
• การสมัครสมาชิกไม่ได้ใช้งานอยู่ หรือการเข้าถึง API ถูกระงับ: ส่วน vpn_keyคีย์ API จะแจ้งไว้