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

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

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

  • URL ฐานของไอคอนมี URL ฐานสำหรับ 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)
โรงพยาบาล
โรงพยาบาล
ตำรวจ
ตำรวจ