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

เลือกแพลตฟอร์ม: Android iOS JavaScript บริการบนเว็บ

ไอคอนสถานที่จะแสดงสถานที่ประเภทต่างๆ (เช่น ร้านกาแฟ ห้องสมุด และพิพิธภัณฑ์) คุณสามารถขอ 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)
โรงพยาบาล
โรงพยาบาล 		ตำรวจ
ตำรวจ