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

เลือกแพลตฟอร์ม: 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)
โรงพยาบาล
โรงพยาบาล 		ตำรวจ
ตำรวจ