ก่อนที่จะเริ่มเขียนโค้ดแอปพลิเคชันไคลเอ็นต์แรก คุณจะต้องทําบางสิ่งต่อไปนี้หากยังไม่ได้ทํา
รับบัญชี 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 วิธี ได้แก่
- การส่งคําขอ HTTP และการแยกวิเคราะห์การตอบกลับ
- การใช้ไลบรารีของไคลเอ็นต์
หากคุณตัดสินใจที่จะไม่ใช้ไลบรารีของไคลเอ็นต์ คุณจะต้องเข้าใจข้อมูลพื้นฐานของ 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