รายละเอียดสถานที่ (ใหม่)

เลือกแพลตฟอร์ม แอนดรอยด์ iOS JavaScript บริการผ่านเว็บ

เมื่อมีรหัสสถานที่แล้ว คุณจะทำสิ่งต่อไปนี้ได้ ขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานประกอบการบางแห่ง หรือ จุดที่น่าสนใจด้วยการเริ่ม รายละเอียดสถานที่ (ใหม่) อีกครั้ง รายละเอียดสถานที่ (ใหม่) ส่งคำขอแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่ที่สมบูรณ์ หมายเลขโทรศัพท์ คะแนนและรีวิวจากผู้ใช้

การรับรหัสสถานที่ทำได้หลายวิธี คุณสามารถใช้

• การค้นหาข้อความ (ใหม่) หรือ การค้นหาใกล้เคียง (ใหม่)
• Geocoding API
• Routes API
• API การตรวจสอบที่อยู่
• เติมข้อความอัตโนมัติเกี่ยวกับสถานที่

โปรแกรมสำรวจ API ช่วยให้คุณสร้างคำขอแบบเรียลไทม์ได้เพื่อทำความคุ้นเคยกับ API และ ตัวเลือก API:

ลองใช้งาน

คำขอรายละเอียดสถานที่ (ใหม่)

คำขอรายละเอียดสถานที่เป็นคำขอ HTTP GET ในรูปแบบ

https://places.googleapis.com/v1/places/PLACE_ID

ส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ URL หรือในส่วนหัวเป็นส่วนหนึ่งของ คำขอ GET เช่น

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

หรือในคำสั่ง cURL:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

การตอบกลับรายละเอียดสถานที่ (ใหม่)

รายละเอียดสถานที่ (ใหม่) แสดง ออบเจ็กต์ JSON เป็นการตอบกลับ ในการตอบกลับ:

• คำตอบจะแสดงด้วย Place ออบเจ็กต์ ออบเจ็กต์ Place มีข้อมูลโดยละเอียดเกี่ยวกับ
• FieldMask ที่ส่งผ่านในคำขอระบุรายการช่อง แสดงในออบเจ็กต์ Place

ออบเจ็กต์ JSON ที่สมบูรณ์อยู่ในรูปแบบดังนี้

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

พารามิเตอร์ที่จำเป็น

• FieldMask

  ระบุรายการช่องที่จะส่งกลับมาในคำตอบโดยสร้าง มาสก์ของช่องตอบกลับ ส่งมาสก์ฟิลด์ตอบกลับไปยังเมธอดโดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP X-Goog-FieldMask คำตอบไม่มีรายการเริ่มต้นของช่องที่ส่งคืน หากคุณไม่มาสก์ช่อง เมธอดจะแสดงข้อผิดพลาด

  การมาสก์ช่องเป็นแนวทางปฏิบัติในการออกแบบที่ดีเพื่อให้แน่ใจว่าคุณไม่ได้ส่งคำขอ ข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาประมวลผลที่ไม่จำเป็น การเรียกเก็บเงินของคุณ

  ระบุรายการประเภทข้อมูลสถานที่ซึ่งคั่นด้วยคอมมาที่จะแสดงผล ตัวอย่างเช่น เพื่อดึงข้อมูลชื่อที่แสดงและที่อยู่ของสถานที่

  X-Goog-FieldMask: displayName,formattedAddress

  หมายเหตุ: ไม่อนุญาตให้ใช้พื้นที่ทำงานทุกที่ ในรายการช่อง

  ใช้ * เพื่อเรียกข้อมูลช่องทั้งหมด

  X-Goog-FieldMask: *

  ไวลด์การ์ด "*" เลือกทุกฟิลด์ อย่างไรก็ตาม แม้ว่า คุณสามารถใช้ไวลด์การ์ดในการพัฒนาได้ แต่ Google ไม่สนับสนุนให้ใช้ มาสก์ฟิลด์ตอบกลับที่ใช้ไวลด์การ์ด (*) ในการใช้งานจริงเนื่องจากมีข้อมูลจำนวนมาก ที่ส่งคืนได้
  คำแนะนำเพิ่มเติมสำหรับการใช้ iconMaskBaseUri และ iconBackgroundColor อยู่ใน ส่วนไอคอนสถานที่

  ระบุช่องต่อไปนี้อย่างน้อย 1 ช่อง

  • ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ (รหัสเท่านั้น)

    attributions, id, name^* photos
    
    ^* ช่อง name จะมีชื่อทรัพยากรสถานที่ ในแบบฟอร์ม: places/PLACE_ID ใช้ displayName เพื่อเข้าถึงชื่อข้อความของสถ านที่

  • ช่องต่อไปนี้จะเรียกใช้ SKU รายละเอียดสถานที่ (สถานที่ตั้งเท่านั้น)

    addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types viewport

  • ช่องต่อไปนี้จะเรียกใช้ SKU รายละเอียดสถานที่ (พื้นฐาน)

    accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType primaryTypeDisplayName, subDestinations, utcOffsetMinutes

  • ช่องต่อไปนี้จะเรียกใช้ SKU รายละเอียดสถานที่ (ขั้นสูง)

    currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours regularSecondaryOpeningHours, userRatingCount, websiteUri

  • ช่องต่อไปนี้จะเรียกใช้ SKU รายละเอียดสถานที่ (ที่ต้องการ)

    allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout
    

• placeId

  ตัวระบุแบบข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน แสดงผลจาก การค้นหาข้อความ (ใหม่) หรือ การค้นหาใกล้เคียง (ใหม่) สำหรับข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ โปรดดูที่ ภาพรวมรหัสสถานที่

  มีอีกชื่อหนึ่งว่าสตริง places/PLACE_ID คือ ชื่อทรัพยากร ในการตอบกลับจากรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) สตริงนี้จะอยู่ในช่อง name ของการตอบกลับ แบบสแตนด์อโลน รหัสสถานที่จะอยู่ในช่อง id ของคำตอบ

  หมายเหตุ: ในบัญชี รายละเอียดสถานที่ ฟิลด์ name ของคำตอบมีชื่อที่มนุษย์อ่านได้สำหรับสถานที่นี้ ใน API ใหม่ ช่องนั้นจะเรียกว่า displayName

พารามิเตอร์ที่ไม่บังคับ

• languageCode

  ภาษาที่จะแสดงผลการค้นหา

  • โปรดดู รายชื่อภาษาที่รองรับ Google มีการอัปเดตบ่อยครั้ง ภาษาที่รองรับ รายการนี้จึงอาจเป็นเพียงตัวอย่างบางส่วนเท่านั้น
  • หากไม่ได้ระบุ languageCode ค่าเริ่มต้นของ API จะเป็น en ถ้า คุณระบุรหัสภาษาไม่ถูกต้อง API จะแสดงข้อผิดพลาด INVALID_ARGUMENT
  • API พยายามอย่างสุดความสามารถเพื่อให้ที่อยู่ที่อ่านได้ง่ายสำหรับ ทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายนี้ โมเดลจึงส่งคืนที่ถนน ที่อยู่ในภาษาท้องถิ่น ถอดเสียงเป็นสคริปต์ที่อ่านได้ ถ้าจำเป็น โดยสังเกตภาษาที่ต้องการ อื่นๆ ทั้งหมด ที่อยู่จะแสดงเป็นภาษาที่ต้องการ องค์ประกอบที่อยู่คือ ทั้งหมดจะแสดงผลในภาษาเดียวกัน โดยเลือกจาก คอมโพเนนต์
  • หากไม่มีชื่อในภาษาที่ต้องการ API จะใช้ ที่ใกล้เคียงที่สุด
  • ภาษาที่ต้องการจะมีอิทธิพลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกจะแสดงผล และลำดับการส่งกลับ โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะแปลตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมาย ใช้ได้ในภาษาหนึ่ง แต่ไม่ใช่อีกภาษาหนึ่ง

• regionCode

  รหัสภูมิภาคที่ใช้ในการจัดรูปแบบการตอบกลับ ระบุเป็น ค่ารหัส CLDR แบบ 2 อักขระ ไม่มีค่าเริ่มต้น

  หากชื่อประเทศของช่อง formattedAddress ในคำตอบตรงกับ regionCode, รหัสประเทศไม่รวมอยู่ใน formattedAddress พารามิเตอร์นี้ไม่มีผลต่อ adrFormatAddress ซึ่งจะรวมประเทศเสมอ หรือใน shortFormattedAddress ซึ่งจะไม่รวมอยู่ด้วย

  รหัส CLDR ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นบางประการเด่นๆ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ในขณะที่รหัส ISO 3166-1 คือ "gb" (โดยทางเทคนิคสำหรับ นิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

• sessionToken

  โทเค็นของเซสชันเป็นสตริงที่ผู้ใช้สร้างขึ้นเพื่อติดตามการเติมข้อความอัตโนมัติ (ใหม่) การเรียกเป็น "เซสชัน" การเติมข้อความอัตโนมัติ (ใหม่) ใช้โทเค็นของเซสชันเพื่อ จัดกลุ่มคำค้นหาและวางขั้นตอนการเลือกในการค้นหาจากการเติมข้อความอัตโนมัติของผู้ใช้ไว้ในเซสชันที่แยกกัน เพื่อวัตถุประสงค์ในการเรียกเก็บเงิน โทเค็นของเซสชันจะส่งไปยังรายละเอียดสถานที่ (ใหม่) การโทรที่เกิดขึ้นหลังการโทรจากการเติมข้อความอัตโนมัติ (ใหม่) สำหรับข้อมูลเพิ่มเติม โปรดดู โทเค็นของเซสชัน

ตัวอย่างรายละเอียดสถานที่

ตัวอย่างต่อไปนี้จะขอรายละเอียดของสถานที่โดย placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

โปรดทราบว่าส่วนหัว X-Goog-FieldMask จะระบุว่า คำตอบ มีฟิลด์ข้อมูลต่อไปนี้ id,displayName การตอบกลับจะอยู่ในรูปแบบดังนี้

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

เพิ่มประเภทข้อมูลในมาสก์ของช่องเพื่อแสดงข้อมูลเพิ่มเติม ตัวอย่างเช่น เพิ่ม formattedAddress,plusCode เพื่อใส่พารามิเตอร์ ที่อยู่และ Plus Code ไว้ในส่วน คำตอบ:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

ตอนนี้การตอบกลับจะอยู่ในรูปแบบดังนี้

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

ลองใช้งาน

โปรแกรมสำรวจ API ช่วยให้คุณสามารถสร้างคำขอตัวอย่าง ที่คุณสามารถทำความคุ้นเคยกับ API และตัวเลือก API

โดยวิธีส่งคำขอมีดังนี้

1. เลือกไอคอน API ที่ด้านขวาของหน้า
2. เลือกตั้งค่าพารามิเตอร์ name เป็น

   places/PLACE_ID

3. ขยายแสดงพารามิเตอร์มาตรฐาน (ไม่บังคับ) และตั้งค่า พารามิเตอร์ fields ในฟิลด์มาสก์
4. เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่คุณต้องการ ใช้ในการส่งคำขอ

5. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนขยาย เพื่อขยายหน้าต่างโปรแกรมสำรวจ API