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

บทนำ

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

ไอคอนแต่ละรายการจะกำหนดโดยช่องคำตอบ 2 ช่อง ได้แก่

• URI ฐานของไอคอนประกอบด้วย 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)
โรงพยาบาล	ตำรวจ