ไอคอนสถานที่จะแสดงสถานที่ประเภทต่างๆ (เช่น ร้านกาแฟ ห้องสมุด และพิพิธภัณฑ์) คุณสามารถขอ URL ของไอคอนในรูปแบบ PNG หรือ SVG รวมถึงสีพื้นหลังของไอคอนที่เกี่ยวข้องด้วยคำขอ "ค้นหาสถานที่" "รายละเอียดสถานที่" "การค้นหาใกล้เคียง" และการค้นหาข้อความ" ไอคอนสามารถใช้ในบรรทัดได้
แต่ละไอคอนจะมีช่องการตอบสนอง 2 ช่อง ดังนี้
- URI ฐานของไอคอนมี URL ฐานสำหรับไอคอนที่ไม่มีสี ลบด้วยนามสกุลของประเภทไฟล์ คุณต้องเพิ่ม
.svg
หรือ.png
ต่อท้าย URI เพื่อขอไอคอน - สีพื้นหลังของไอคอนมีรหัสสี HEX เริ่มต้นสำหรับหมวดหมู่ของสถานที่
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีขอ URI ไอคอนและสีพื้นหลังสำหรับ Places API (ใหม่) และ Places API โปรดสังเกตว่าคำขอและการตอบกลับนั้น แตกต่างกันสำหรับ API ทั้ง 2 เวอร์ชัน
Places API (ใหม่)
ตัวอย่างต่อไปนี้ใช้การค้นหาข้อความ (ใหม่) เพื่อแสดงชื่อที่แสดงของสถานที่ รวมถึงช่องคําตอบ iconMaskBaseUri
และ iconBackgroundColor
curl -X POST -d '{ "textQuery" : "skog haus", "maxResultCount" : 1 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.iconMaskBaseUri,places.iconBackgroundColor' \ 'https://places.googleapis.com/v1/places:searchText'
คำตอบจะมีรูปแบบดังนี้
{ "places": [ { "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet", "iconBackgroundColor": "#FF9E67", "displayName": { "text": "SKÖG Haus Coffee & Tea", "languageCode": "en" } } ] }
Places API
ตัวอย่างต่อไปนี้แสดงคำขอค้นหาสถานที่ ที่มีช่อง icon_mask_base_uri
และ icon_background_color
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=skog%20haus&inputtype=textquery&fields=name,icon_mask_base_uri,icon_background_color&key=API_KEY
ตัวอย่างต่อไปนี้แสดงลักษณะที่ช่อง icon_mask_base_uri
และ icon_background_color
ปรากฏในการตอบกลับจากคำขอค้นหาสถานที่
JSON
{ "candidates" : [ { "icon_background_color" : "#FF9E67", "icon_mask_base_uri" : "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet", "name" : "SKÖG Haus Coffee", } ], "status" : "OK" }
XML
<FindPlaceFromTextResponse> <candidates> <name>SKÖG Haus Coffee</name> <icon_background_color>#FF9E67</icon_background_color> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet</icon_mask_base_uri> </candidates> <status>OK</status> </FindPlaceFromTextResponse>
หากต้องการแสดงไอคอน ให้เพิ่มนามสกุลของไฟล์ที่ต้องการ (.png หรือ .svg) ต่อท้ายไอคอนที่ส่งคืน URI และรวมไอคอนเข้ากับสีพื้นหลังที่แสดง เช่น เมื่อต้องการแสดงไอคอน .svg ในหน้าเว็บ ให้ทำดังนี้
<style> .icons-food-drink { background-color: #FF9E67; width: 88px; height: 88px; padding: 5px; } </style> <img src="https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet.svg" alt="Cafe" class="icons-food-drink"/>
คำขอไอคอนสถานที่และสีพื้นหลัง
ตารางต่อไปนี้แสดงไอคอนสถานที่ที่มีอยู่ทั้งหมดตามหมวดหมู่ โดยค่าเริ่มต้น การแสดงผลเหล่านี้จะแสดงด้วยรูปอักขระสีดำ สีพื้นหลังของไอคอน จะถูกกำหนดตามหมวดหมู่ของสถานที่
หมวดหมู่สถานที่: อาหารและเครื่องดื่ม (สีพื้นหลังไอคอน #FF9E67) |
|||
---|---|---|---|
บาร์, ไนท์คลับ |
คาเฟ่ |
ร้านอาหาร, เบเกอรี่ |
|
หมวดหมู่สถานที่: ค้าปลีก (สีพื้นหลังไอคอน #4B96F3) |
|||
หนังสือ เสื้อผ้า อุปกรณ์อิเล็กทรอนิกส์ เครื่องประดับ รองเท้า ศูนย์การค้า/ห้างสรรพสินค้า |
ร้านสะดวกซื้อ |
ของชำ, ซูเปอร์มาร์เก็ต |
ร้านขายยา |
หมวดหมู่สถานที่: บริการ (สีพื้นหลังไอคอน #909CE1) |
|||
ตู้เอทีเอ็ม |
ธนาคาร |
แก๊ส |
ที่พัก |
ที่ทำการไปรษณีย์ |
|||
หมวดหมู่สถานที่: บันเทิง (สีพื้นหลังไอคอน #13B5C7) |
|||
พิพิธภัณฑ์สัตว์น้ำ นักท่องเที่ยว |
กอล์ฟ |
ประวัติศาสตร์ |
ภาพยนตร์ |
พิพิธภัณฑ์ |
โรงภาพยนตร์ |
||
หมวดหมู่สถานที่: การขนส่ง (สีพื้นหลังไอคอน #10BDFF) |
|||
สนามบิน |
รถประจำทาง บริการร่วมเดินทาง แท็กซี่ |
รถไฟ/รถไฟ |
|
หมวดหมู่สถานที่: เทศบาล/ทั่วไป/ศาสนา (สีพื้นหลังไอคอน #7B9EB0) |
|||
สุสาน |
ศาลากลาง |
คลัง |
อนุสาวรีย์ |
ที่จอดรถ |
โรงเรียน (ประถมศึกษา มัธยมศึกษา มหาวิทยาลัย) |
การสักการะ (คริสเตียน) |
|
สักการะ (ฮินดู) |
การสักการะ (ศาสนาอิสลาม) |
การสักการะ (เชน) |
สักการะ (ชาวยิว) |
สักการะ (ซิกข์) |
ธุรกิจทั่วไป |
||
หมวดหมู่สถานที่: กลางแจ้ง (สีพื้นหลังไอคอน #4DB546) |
|||
การแล่นเรือ |
การตั้งแคมป์ |
อุทยาน |
สนามกีฬา |
สวนสัตว์ |
|||
หมวดหมู่สถานที่: ฉุกเฉิน (สีพื้นหลังไอคอน #F88181) |
|||
โรงพยาบาล |
ตำรวจ |