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

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