ไอคอนสถานที่

ไอคอนสถานที่บ่งบอกถึงสถานที่ประเภทต่างๆ (เช่น ร้านกาแฟ ห้องสมุด และพิพิธภัณฑ์) คุณสามารถขอ URL สำหรับไอคอนในรูปแบบ PNG หรือ SVG รวมทั้งสีพื้นหลังของไอคอนที่สอดคล้องกัน พร้อมค้นหาสถานที่ รายละเอียดสถานที่ การค้นหาบริเวณใกล้เคียง และการค้นหาข้อความ คุณสามารถใช้ไอคอนแบบในหน้าได้

แต่ละไอคอนจะมีช่องคำตอบ 2 ช่อง ดังนี้

• URL ฐานของไอคอนมี URL ฐานสำหรับ URL ที่ไม่มีสี ลบนามสกุลประเภทไฟล์ คุณต้องเพิ่ม .svg หรือ .png ไปยัง URI เพื่อขอไอคอน
• สีพื้นหลังของไอคอนมีรหัสสี HEX เริ่มต้นสำหรับ หมวดหมู่ของสถานที่

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีขอ URI ไอคอนและสีพื้นหลังสำหรับ Places API (ใหม่) และ Places API โปรดสังเกตว่าคำขอและคำตอบแตกต่างกัน สำหรับ API ทั้ง 2 เวอร์ชัน

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"
      }
    }
  ]
}

    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

    {
      "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"
    }
          

    <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)
โรงพยาบาล	ตำรวจ