ข้อกำหนดที่จำเป็น

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

รับบัญชี 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 นั้นเรียกสั้นๆ ว่า "การรับรองสถานะตัวแทน." ในบริบทของ Google APIs การอ้างถึงคํากริยา HTTP จะดึงข้อมูลและแก้ไขการนําเสนอที่ Google จัดเก็บไว้

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

ใน API ของ RESTful ของ 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 มีดังนี้

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