สิ่งที่ต้องดำเนินการก่อน

ก่อนที่คุณจะสามารถเริ่มเขียนโค้ดแอปพลิเคชันไคลเอ็นต์แรกของคุณ มี สิ่งที่คุณต้องทำ หากคุณยังไม่ได้ทำ

รับบัญชี Google

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

คุณอาจต้องการบัญชี Google แยกต่างหากเพื่อวัตถุประสงค์ในการทดสอบ

ลองใช้ Google Street View

เอกสารประกอบเกี่ยวกับ API นี้จะถือว่าคุณใช้ Google Street View และคุ้นเคยกับแนวคิดการเขียนโปรแกรมเว็บและรูปแบบข้อมูลเว็บ

หากยังไม่ได้ใช้ Google Street View ให้ลองใช้อินเทอร์เฟซผู้ใช้ก่อนเริ่มเขียนโค้ด

สร้างโปรเจ็กต์สำหรับไคลเอ็นต์

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

คุณต้องทำสิ่งต่อไปนี้ก่อนจึงจะเริ่มใช้ Google Street View Publish API ได้ ใช้ เครื่องมือตั้งค่า ซึ่งจะแนะนำขั้นตอนการสร้างโปรเจ็กต์ใน คอนโซล Google API, การเปิดใช้ API และการสร้างข้อมูลเข้าสู่ระบบ

ถ้าคุณยังไม่ได้ดำเนินการ ให้สร้างคีย์ API ของแอปพลิเคชันโดยคลิก สร้างข้อมูลเข้าสู่ระบบ > คีย์ API ถัดไป ให้มองหาคีย์ API ของคุณใน API คีย์

ดูข้อมูลพื้นฐานเกี่ยวกับ REST

การเรียก API ทำได้ 2 วิธีดังนี้

หากคุณตัดสินใจไม่ใช้ไลบรารีของไคลเอ็นต์ คุณจะต้องทำความเข้าใจพื้นฐานของ REST

REST คือรูปแบบสถาปัตยกรรมซอฟต์แวร์ที่ให้วิธีการขอและแก้ไขข้อมูลที่สะดวกและสอดคล้องกัน

คำว่า REST เป็นคำสั้นๆ ของ "Sentational State Transfer" ในบริบทของ Google APIs หมายถึงการใช้คำกริยา HTTP เพื่อดึงและแก้ไขการนำเสนอข้อมูลที่ Google จัดเก็บไว้

ในระบบ RESTful ทรัพยากรจะจัดเก็บอยู่ในพื้นที่เก็บข้อมูล ไคลเอ็นต์จะส่งคำขอเพื่อให้เซิร์ฟเวอร์ดำเนินการบางอย่าง (เช่น สร้าง เรียก อัปเดต หรือลบทรัพยากร) และเซิร์ฟเวอร์จะดำเนินการดังกล่าวและส่งการตอบกลับ ซึ่งมักอยู่ในรูปแบบเป็นตัวแทนของทรัพยากรที่ระบุ

ใน RESTful API ของ Google ไคลเอ็นต์จะระบุการทำงานโดยใช้คำกริยา HTTP เช่น POST, GET, PUT หรือ DELETE โดยจะระบุทรัพยากรตาม URI ที่ไม่ซ้ำกันทั่วโลกในรูปแบบต่อไปนี้

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

เนื่องจากทรัพยากร API ทั้งหมดมี URI ที่ไม่ซ้ำกันซึ่งเข้าถึง HTTP ได้ REST จะเปิดใช้การแคชข้อมูล และได้รับการเพิ่มประสิทธิภาพให้ทำงานกับโครงสร้างพื้นฐานแบบกระจายของเว็บ

ดูคำจำกัดความของเมธอดในเอกสารประกอบของมาตรฐาน HTTP 1.1 ซึ่งมีประโยชน์มาก มีข้อมูลจำเพาะสำหรับ GET, POST, PUT และ DELETE

REST ใน Google Street View Publish API

แมปการดำเนินการ Google Street View Publish API โดยตรงกับคำกริยา HTTP ของ REST

รูปแบบเฉพาะสำหรับ URI ของ Google Street View Publish API ได้แก่

https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters

ชุด URI แบบเต็มที่ใช้สำหรับการดำเนินการที่รองรับแต่ละรายการใน API จะสรุปไว้ในเอกสารเอกสารอ้างอิง API การเผยแพร่ของ Google Street View

ดูข้อมูลเบื้องต้นเกี่ยวกับ JSON

Google Street View Publish API แสดงผลข้อมูลในรูปแบบ JSON

JSON (JavaScript Object Notation) เป็นรูปแบบข้อมูลทั่วไปที่ไม่ขึ้นอยู่กับภาษา ซึ่งมีการนำเสนอแบบข้อความอย่างง่ายของโครงสร้างข้อมูลที่กำหนดเอง สำหรับข้อมูลเพิ่มเติม โปรดดู json.org