ไอคอนสถานที่จะแสดงประเภทต่างๆ ของสถานที่ (เช่น ร้านกาแฟ ห้องสมุด และพิพิธภัณฑ์) คุณสามารถขอ 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) |
|||
สุสาน |
ศาลากลาง |
คลัง |
อนุสาวรีย์ |
ที่จอดรถ |
โรงเรียน (ประถมศึกษา มัธยมศึกษา มหาวิทยาลัย) |
การสักการะ (คริสเตียน) |
|
การสักการะ (ฮินดู) |
การสักการะ (ศาสนาอิสลาม) |
การสักการะ (เชน) |
การสักการะ (ชาวยิว) |
สักการะ (Sikh) |
ธุรกิจทั่วไป |
||
หมวดหมู่สถานที่: กลางแจ้ง (สีพื้นหลังของไอคอน #4DB546) |
|||
การแล่นเรือ |
การตั้งแคมป์ |
อุทยาน |
สนามกีฬา |
สวนสัตว์ |
|||
หมวดหมู่สถานที่: ฉุกเฉิน (สีพื้นหลังของไอคอน #F88181) |
|||
โรงพยาบาล |
ตำรวจ |