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

เลือกแพลตฟอร์ม: Android iOS JavaScript เว็บเซอร์วิส
นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

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

คุณรับรหัสสถานที่ได้หลายวิธี โดยสามารถใช้สิ่งต่อไปนี้

โปรแกรมสำรวจ 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: *

    ระบุฟิลด์ต่อไปนี้อย่างน้อย 1 รายการ

    • ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบจำเป็น (เฉพาะรหัส):

      attributions
      id
      moved_place
      moved_place_id
      name*
      photos

      * ฟิลด์ name มี ชื่อทรัพยากร ของสถานที่ในรูปแบบ places/PLACE_ID หากต้องการรับชื่อข้อความของสถานที่ ให้ขอฟิลด์ displayName ใน SKU ระดับโปร

    • ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบจำเป็น:

      addressComponents
      addressDescriptor*
      adrFormatAddress
      formattedAddress
      location
      plusCode
      postalAddress
      shortFormattedAddress
      types
      viewport

      * ตัวอธิบายที่อยู่พร้อมให้บริการแก่ลูกค้าในอินเดียโดยทั่วไป และเป็นเวอร์ชันทดลองในประเทศอื่นๆ

    • ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ระดับโปร:

      accessibilityOptions
      businessStatus
      containingPlaces
      displayName
      googleMapsLinks
      googleMapsUri
      iconBackgroundColor
      iconMaskBaseUri
      openingDate
      primaryType
      primaryTypeDisplayName
      pureServiceAreaBusiness
      subDestinations
      timeZone
      utcOffsetMinutes

    • ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ระดับ Enterprise:

      currentOpeningHours
      currentSecondaryOpeningHours
      internationalPhoneNumber
      nationalPhoneNumber
      priceLevel
      priceRange
      rating
      regularOpeningHours
      regularSecondaryOpeningHours
      transitStation
      userRatingCount
      websiteUri

    • ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ระดับ Enterprise + บรรยากาศ:

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

      * การค้นหาข้อความและการค้นหาในบริเวณใกล้เคียงเท่านั้น

  • placeId

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

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

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

  • 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"
  }
}

รับตัวอธิบายที่อยู่

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

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

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

การตอบกลับประกอบด้วยสถานที่ที่ระบุในคำขอ รายการสถานที่สำคัญใกล้เคียงและระยะทางจากสถานที่ รวมถึงรายการพื้นที่และความสัมพันธ์ในการบรรจุสถานที่

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

รับรายละเอียดสถานที่สำหรับสถานที่ที่ย้ายแล้ว

หากสถานที่ที่อ้างอิงในแอปของคุณย้ายที่ตั้ง คุณสามารถใช้ movedPlace และ movedPlaceId ฟิลด์เพื่อรับรายละเอียดของสถานที่ใหม่ได้

สำหรับสถานที่ที่ปิดถาวร รายละเอียดสถานที่ (ใหม่) จะแสดงผล CLOSED_PERMANENTLY ในฟิลด์ businessStatus และละเว้นฟิลด์ movedPlace และ movedPlaceId ในเนื้อหาการตอบกลับ

สำหรับสถานที่ที่ย้ายไปยังสถานที่ใหม่ รายละเอียดสถานที่ (ใหม่) จะแสดงผล CLOSED_PERMANENTLY ในฟิลด์ businessStatus และแสดงผลสถานที่ใหม่ในฟิลด์ movedPlace และ movedPlaceId ของเนื้อหาการตอบกลับ

สำหรับสถานที่ที่ไม่ได้ย้าย รายละเอียดสถานที่ (ใหม่) จะไม่แสดงผล movedPlace หรือ movedPlaceId ในเนื้อหาการตอบกลับ

ตัวอย่างต่อไปนี้จะขอข้อมูลสถานที่เกี่ยวกับ Marche IGA St-Canut ในรัฐควิเบก ประเทศแคนาดา

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

คำขอจะแสดงผลการตอบกลับต่อไปนี้

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

หากต้องการขอรายละเอียดเกี่ยวกับสถานที่ใหม่ ให้ใช้ชื่อทรัพยากรของสถานที่ในฟิลด์ movedPlace ในคำขอรายละเอียดสถานที่ (ใหม่) ใหม่

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

ค้นหาธุรกิจที่จะเปิดในอนาคต

คุณสามารถขอรายละเอียดเกี่ยวกับธุรกิจที่คาดว่าจะเปิดในอนาคตได้ การค้นหาในบริเวณใกล้เคียง (ใหม่) จะป้อนข้อมูลในฟิลด์ openingDate หากวันที่เปิดที่คาดไว้ มีอย่างน้อยเดือนและอยู่ห่างออกไปไม่เกิน 90 วัน

ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาในบริเวณใกล้เคียง (ใหม่) สำหรับธุรกิจที่จะเปิดใน อนาคตในนิวมีโดวส์ รัฐไอดาโฮ

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

การตอบกลับประกอบด้วยสถานะธุรกิจและวันที่เปิดที่คาดไว้ของสถานที่

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

รับข้อมูลสถานีขนส่งสาธารณะ

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

ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลสถานีขนส่งสาธารณะสำหรับสถานีแกรนด์เซ็นทรัล

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

เนื้อหาการตอบกลับประกอบด้วยข้อมูลเกี่ยวกับแต่ละสถานีภายในรัศมี เส้นทางที่สถานีให้บริการ การแจ้งเตือนที่หน่วยงานขนส่งสาธารณะออกที่ป้ายนั้น และข้อมูลการออกเดินทาง

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

ลองใช้งาน

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

  1. เลือกไอคอน API api ทางด้านขวาของหน้า

  2. แก้ไขพารามิเตอร์คำขอตามต้องการ

  3. เลือกปุ่มเรียกใช้ ในกล่องโต้ตอบ ให้เลือกบัญชี ที่ต้องการใช้ส่งคำขอ

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