การขอเส้นทาง

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

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

ตัวอย่างการตอบกลับ

ระบบจะแสดงผลการตอบกลับเส้นทางในรูปแบบที่ระบุโดยแฟล็ก output ภายในเส้นทางคำขอ URL

ตัวอย่างคำขอ HTTP ด้านล่างแสดงการคำนวณเส้นทางจากชิคาโก รัฐอิลลินอยส์ ไปยังลอสแอนเจลิส รัฐแคลิฟอร์เนีย ผ่านจุดอ้างอิง 2 จุดในจอปลิน รัฐมิสซูรี และโอคลาโฮมาซิตี รัฐโอคลาโฮมา

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

ตัวอย่างด้านบนขอเอาต์พุต JSON นอกจากนี้ คุณยังขอเอาต์พุต XML ได้ด้วย เลือกแท็บด้านล่างเพื่อดูตัวอย่างการตอบกลับ JSON และ XML

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

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

  • ผลลัพธ์ XML จะรวมอยู่ในองค์ประกอบ <DirectionsResponse> รูท
  • JSON จะแสดงรายการที่มีองค์ประกอบหลายรายการด้วยอาร์เรย์พหูพจน์ (เช่น steps และ legs) ส่วน XML จะแสดงรายการเหล่านี้โดยใช้องค์ประกอบเอกพจน์หลายรายการ (เช่น <step> และ <leg>)
  • JSON จะระบุลำดับจุดอ้างอิงผ่านช่อง waypoint_order ส่วน XML จะระบุลำดับจุดอ้างอิงโดยใช้องค์ประกอบ <waypoint_index> แต่ละรายการ
  • องค์ประกอบที่ว่างเปล่าจะแสดงผ่านอาร์เรย์ที่ว่างเปล่าใน JSON แต่จะแสดงโดยไม่มีองค์ประกอบดังกล่าวใน XML ตัวอย่างเช่น การตอบกลับที่ไม่สร้างผลลัพธ์จะแสดงผลอาร์เรย์ routes ที่ว่างเปล่าใน JSON แต่ไม่มีองค์ประกอบ <route> ใน XML

DirectionsResponse

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ Array<DirectionsRoute>

มีอาร์เรย์ของเส้นทางจากต้นทางไปยังจุดหมาย เส้นทางประกอบด้วย Leg และ Step ที่ซ้อนกัน

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsRoute
ต้องระบุ DirectionsStatus

มีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่องเพื่อช่วยคุณติดตามสาเหตุที่คำขอล้มเหลว

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsStatus
ไม่บังคับ Array<TravelMode>

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

ดูข้อมูลเพิ่มเติมได้ที่ TravelMode
ไม่บังคับ สตริง

เมื่อบริการแสดงรหัสสถานะอื่นที่ไม่ใช่ OK อาจมีช่อง error_message เพิ่มเติมภายในออบเจ็กต์การตอบกลับ ช่องนี้มีข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับสาเหตุที่อยู่เบื้องหลังรหัสสถานะที่ระบุ ระบบอาจไม่แสดงช่องนี้เสมอไป และเนื้อหาอาจมีการเปลี่ยนแปลง

ไม่บังคับ Array<DirectionsGeocodedWaypoint>

มีอาร์เรย์ที่มีรายละเอียดเกี่ยวกับการเข้ารหัสพิกัดภูมิศาสตร์ของต้นทาง ปลายทาง และจุดอ้างอิง องค์ประกอบในอาร์เรย์ geocoded_waypoints จะสอดคล้องกับจุดเริ่มต้น จุดอ้างอิงตามลำดับที่ระบุ และจุดหมาย โดยอิงตามตำแหน่งที่เริ่มจาก 0

รายละเอียดเหล่านี้จะไม่แสดงสำหรับจุดอ้างอิงที่ระบุเป็นค่าละติจูด/ลองจิจูดแบบข้อความหากบริการไม่แสดงผลลัพธ์ เนื่องจากจุดอ้างอิงดังกล่าวจะได้รับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับเพื่อรับที่อยู่ตัวแทนหลังจากพบเส้นทางแล้วเท่านั้น ออบเจ็กต์ JSON ที่ว่างเปล่าจะอยู่ในตำแหน่งที่สอดคล้องกันในอาร์เรย์ geocoded_waypoints

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsGeocodedWaypoint

DirectionsRoute

เส้นทางประกอบด้วย legs และ steps ที่ซ้อนกัน

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ ขอบเขต

มีกรอบล้อมรอบวิวพอร์ตของ overview_polyline

ดูข้อมูลเพิ่มเติมได้ที่ขอบเขต
ต้องระบุ สตริง

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

ต้องระบุ Array<DirectionsLeg>

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

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsLeg
ต้องระบุ DirectionsPolyline

มีออบเจ็กต์ที่เก็บการแสดงเส้นประกอบที่เข้ารหัสของเส้นทาง เส้นประกอบนี้เป็นเส้นทางโดยประมาณ (ปรับให้ราบรื่น) ของเส้นทางที่ได้

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsPolyline
ต้องระบุ สตริง

มีคำอธิบายข้อความสั้นๆ สำหรับเส้นทาง ซึ่งเหมาะสำหรับการตั้งชื่อและแยกความแตกต่างของเส้นทางจากทางเลือกอื่นๆ

ต้องระบุ Array<string>

มีอาร์เรย์ของคำเตือนที่จะแสดงเมื่อแสดงเส้นทางเหล่านี้ คุณต้องจัดการและแสดงคำเตือนเหล่านี้ด้วยตนเอง

ต้องระบุ Array<integer>

อาร์เรย์ที่ระบุลำดับของจุดอ้างอิงในเส้นทางที่คำนวณ ระบบอาจจัดเรียงจุดอ้างอิงนี้ใหม่หากมีการส่งคำขอ optimize:true ภายในพารามิเตอร์จุดอ้างอิง

ไม่บังคับ ค่าโดยสาร

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

ดูข้อมูลเพิ่มเติมได้ที่ค่าโดยสาร

ขอบเขต

สี่เหลี่ยมผืนผ้าในพิกัดทางภูมิศาสตร์จากจุดที่มุมตะวันตกเฉียงใต้และตะวันออกเฉียงเหนือ

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ LatLngLiteral ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral
ต้องระบุ LatLngLiteral ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral

LatLngLiteral

ออบเจ็กต์ที่อธิบายสถานที่ตั้งที่เฉพาะเจาะจงด้วยละติจูดและลองจิจูดในรูปแบบองศาทศนิยม

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ ตัวเลข

ละติจูดในหน่วยองศาทศนิยม
ต้องระบุ ตัวเลข

ลองจิจูดในหน่วยองศาทศนิยม

DirectionsLeg

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ สตริง

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

ต้องระบุ LatLngLiteral

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

ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral
ต้องระบุ สตริง

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

ต้องระบุ LatLngLiteral

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

ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral
ต้องระบุ Array<DirectionsStep>

อาร์เรย์ของขั้นตอนที่แสดงข้อมูลเกี่ยวกับแต่ละขั้นตอนที่แยกกันของช่วงการเดินทาง

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsStep

traffic_speed_entry

ไม่บังคับ Array<DirectionsTrafficSpeedEntry>

ข้อมูลเกี่ยวกับความเร็วของการจราจรตลอดช่วงการเดินทาง

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsTrafficSpeedEntry

ต้องระบุ Array<DirectionsViaWaypoint>

ตำแหน่งของจุดอ้างอิงที่ผ่านตามเส้นทางช่วงนี้

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsViaWaypoint

ไม่บังคับ TimeZoneTextValueObject

มีเวลาถึงโดยประมาณสำหรับการเดินทางช่วงนี้ ระบบจะแสดงพร็อพเพอร์ตี้นี้สำหรับเส้นทางขนส่งสาธารณะเท่านั้น

ดูข้อมูลเพิ่มเติมได้ที่ TimeZoneTextValueObject

ไม่บังคับ TimeZoneTextValueObject

มีเวลาออกเดินทางโดยประมาณสำหรับการเดินทางช่วงนี้ โดยระบุเป็นออบเจ็กต์ Time departure_time ใช้ได้กับเส้นทางขนส่งสาธารณะเท่านั้น

ดูข้อมูลเพิ่มเติมได้ที่ TimeZoneTextValueObject

ไม่บังคับ TextValueObject

ระยะทางรวมที่ครอบคลุมโดยช่วงนี้

ดูข้อมูลเพิ่มเติมได้ที่ TextValueObject
ไม่บังคับ TextValueObject

ระยะเวลาทั้งหมดของเส้นทางนี้

ดูข้อมูลเพิ่มเติมได้ที่ TextValueObject
ไม่บังคับ TextValueObject

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

  • คำขอไม่มีจุดอ้างอิงสำหรับการแวะพัก หากคำขอมีจุดอ้างอิง ต้องใส่คำนำหน้า via: เพื่อหลีกเลี่ยงการแวะพัก
  • คำขอนี้มีไว้สำหรับเส้นทางการขับขี่โดยเฉพาะ โดยพารามิเตอร์โหมดจะตั้งค่าเป็น driving
  • คำขอมีพารามิเตอร์ departure_time
  • สภาพการจราจรพร้อมใช้งานสำหรับเส้นทางที่ขอ

ดูข้อมูลเพิ่มเติมได้ที่ TextValueObject

DirectionsStep

แต่ละองค์ประกอบในอาร์เรย์ steps จะกำหนดขั้นตอนเดียวของเส้นทางที่คำนวณ ขั้นตอนคือหน่วยที่เล็กที่สุดของเส้นทางในคำแนะนำ โดยมีขั้นตอนเดียวที่อธิบายคำสั่งเฉพาะรายการเดียวในการเดินทาง เช่น "เลี้ยวซ้ายที่ถนน W. 4th St." ขั้นตอนไม่เพียงอธิบายคำสั่งเท่านั้น แต่ยังมีข้อมูลระยะทางและระยะเวลาที่เกี่ยวข้องกับความสัมพันธ์ของขั้นตอนนี้กับขั้นตอนต่อไปด้วย ตัวอย่างเช่น ขั้นตอนที่ระบุว่า "เข้าสู่ I-80 West" อาจมีระยะเวลา "37 ไมล์" และ "40 นาที" ซึ่งบ่งบอกว่าขั้นตอนถัดไปอยู่ห่างจากขั้นตอนนี้ 37 ไมล์/40 นาที

เมื่อใช้ Directions API เพื่อค้นหาเส้นทางขนส่งสาธารณะ อาร์เรย์ steps จะมีรายละเอียดขนส่งสาธารณะเพิ่มเติมในรูปแบบของอาร์เรย์ transit_details หากเส้นทางมีรูปแบบการเดินทางหลายรูปแบบ ระบบจะแสดงเส้นทางแบบละเอียดสำหรับขั้นตอนการเดินหรือการขับรถในอาร์เรย์ขั้นตอนภายใน ตัวอย่างเช่น ขั้นตอนการเดินจะรวมเส้นทางจากสถานที่เริ่มต้นและสถานที่สิ้นสุด: "เดินไปที่ Innes Ave และ Fitch St" ขั้นตอนดังกล่าวจะรวมเส้นทางเดินเท้าโดยละเอียดสำหรับเส้นทางนั้นในอาร์เรย์ขั้นตอนภายใน เช่น "มุ่งหน้าไปทางตะวันตกเฉียงเหนือ" "เลี้ยวซ้ายเข้าสู่ Arelious Walker" และ "เลี้ยวซ้ายเข้าสู่ Innes Ave"

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ TextValueObject

มีเวลาที่ใช้โดยทั่วไปในการทำตามขั้นตอนจนถึงขั้นตอนถัดไป ช่องนี้อาจไม่ได้กำหนดไว้หากไม่ทราบระยะเวลา

ดูข้อมูลเพิ่มเติมได้ที่ TextValueObject
ต้องระบุ LatLngLiteral

มีตำแหน่งของจุดสุดท้ายของขั้นตอนนี้

ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral
ต้องระบุ สตริง

มีวิธีการที่จัดรูปแบบแล้วสำหรับขั้นตอนนี้ โดยแสดงเป็นสตริงข้อความ HTML เนื้อหานี้มีไว้เพื่อให้อ่านตามที่เป็นอยู่ อย่าแยกวิเคราะห์เนื้อหาที่แสดงเท่านั้นนี้แบบเป็นโปรแกรม

ต้องระบุ DirectionsPolyline

มีออบเจ็กต์จุดเดียวที่เก็บการแสดงเส้นประกอบที่เข้ารหัสของขั้นตอน เส้นประกอบนี้เป็นเส้นทางโดยประมาณ (ปรับให้ราบรื่น) ของขั้นตอน

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsPolyline
ต้องระบุ LatLngLiteral

มีตำแหน่งของจุดเริ่มต้นของขั้นตอนนี้

ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral
ต้องระบุ TravelMode

มีประเภทของโหมดการเดินทางที่ใช้

ดูข้อมูลเพิ่มเติมได้ที่ TravelMode
ไม่บังคับ TextValueObject

มีระยะทางที่ครอบคลุมโดยขั้นตอนนี้จนถึงขั้นตอนถัดไป ช่องนี้อาจไม่ได้กำหนดไว้หากไม่ทราบระยะทาง

ดูข้อมูลเพิ่มเติมได้ที่ TextValueObject
ไม่บังคับ สตริง

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

The allowed values include: turn-slight-left, turn-sharp-left, turn-left, turn-slight-right, turn-sharp-right, keep-right, keep-left, uturn-left, uturn-right, turn-right, straight, ramp-left, ramp-right, merge, fork-left, fork-right, ferry, ferry-train, roundabout-left, and roundabout-right
ไม่บังคับ

มีเส้นทางโดยละเอียดสำหรับขั้นตอนการเดินหรือการขับรถในเส้นทางขนส่งสาธารณะ ขั้นตอนย่อยจะใช้ได้เฉพาะเมื่อตั้งค่า travel_mode เป็น "ขนส่งสาธารณะ" เท่านั้น อาร์เรย์ขั้นตอนภายในเป็นประเภทเดียวกับขั้นตอน

ไม่บังคับ DirectionsTransitDetails

รายละเอียดที่เกี่ยวข้องกับขั้นตอนนี้หากโหมดการเดินทางคือ transit

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsTransitDetails

TextValueObject

ออบเจ็กต์ที่มีค่าตัวเลขและการแสดงข้อความที่จัดรูปแบบ

ช่อง ต้องระบุ ประเภท คำอธิบาย

text

ต้องระบุ สตริง

ค่าสตริง
ต้องระบุ ตัวเลข

ค่าตัวเลข

DirectionsPolyline

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

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

นอกจากนี้ เพื่อประหยัดพื้นที่ จุดต่างๆ จะมีเฉพาะออฟเซ็ตจากจุดก่อนหน้า (ยกเว้นจุดแรก) จุดทั้งหมดจะเข้ารหัสใน Base64 เป็นจำนวนเต็มแบบมีเครื่องหมาย เนื่องจากละติจูดและลองจิจูดเป็นค่าแบบมีเครื่องหมาย รูปแบบการเข้ารหัสภายในเส้นประกอบต้องแสดงพิกัด 2 รายการที่แสดงละติจูดและลองจิจูดด้วยความแม่นยำที่สมเหตุสมผล เมื่อกำหนดลองจิจูดสูงสุด +/- 180 องศาให้มีความแม่นยำทศนิยม 5 ตำแหน่ง (180.00000 ถึง -180.00000) จะส่งผลให้ต้องใช้ค่าจำนวนเต็มไบนารีแบบมีเครื่องหมายขนาด 32 บิต

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ สตริง

การแสดงสตริงเดียวของเส้นประกอบ

TravelMode

  • DRIVING (ค่าเริ่มต้น) หมายถึงการคำนวณโดยใช้เครือข่ายถนน
  • BICYCLING ขอการคำนวณสำหรับการปั่นจักรยานโดยใช้เส้นทางจักรยานและถนนที่ต้องการ (หากมี)
  • TRANSIT ขอการคำนวณโดยใช้เส้นทางขนส่งสาธารณะ (หากมี)
  • WALKING ขอการคำนวณสำหรับการเดินโดยใช้ทางเท้าและทางเดิน (หากมี)

DirectionsTransitDetails

ข้อมูลเพิ่มเติมที่ไม่เกี่ยวข้องกับรูปแบบการเดินทางอื่นๆ

ช่อง ต้องระบุ ประเภท คำอธิบาย
ไม่บังคับ DirectionsTransitStop

ป้ายจอดรถสาธารณะขาเข้า

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsTransitStop

ไม่บังคับ TimeZoneTextValueObject ดูข้อมูลเพิ่มเติมได้ที่ TimeZoneTextValueObject
ไม่บังคับ DirectionsTransitStop

ป้ายรถโดยสารขาออก

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsTransitStop

ไม่บังคับ TimeZoneTextValueObject ดูข้อมูลเพิ่มเติมได้ที่ TimeZoneTextValueObject
ไม่บังคับ สตริง

ระบุทิศทางการเดินทางในสายนี้ตามที่ระบุไว้บนยานพาหนะหรือที่ป้ายหยุดรถต้นทาง ซึ่งมักจะเป็นสถานีปลายทาง

ไม่บังคับ จำนวนเต็ม

ระบุจำนวนวินาทีที่คาดไว้ระหว่างการออกเดินทางจากป้ายเดียวกัน ณ เวลานี้ เช่น หากค่า headway เป็น 600 คุณจะต้องรอ 10 นาทีหากตกรถประจำทาง

ไม่บังคับ DirectionsTransitLine

มีข้อมูลเกี่ยวกับสายขนส่งสาธารณะที่ใช้ในขั้นตอนนี้

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsTransitLine

ไม่บังคับ จำนวนเต็ม

จำนวนป้ายจอดจากป้ายต้นทางไปยังป้ายปลายทาง ซึ่งรวมถึงป้ายขาเข้า แต่ไม่รวมป้ายขาออก ตัวอย่างเช่น หากเส้นทางของคุณเกี่ยวข้องกับการออกจากป้าย A ผ่านป้าย B และ C และมาถึงป้าย D num_stops จะแสดงผลเป็น 3

ไม่บังคับ สตริง

ข้อความที่ปรากฏในตารางเวลาและป้ายบอกทางเพื่อระบุการเดินทางขนส่งสาธารณะให้ผู้โดยสารทราบ ข้อความควรระบุการเดินทางที่ไม่ซ้ำกันภายในวันให้บริการ ตัวอย่างเช่น "538" คือ trip_short_name ของรถไฟ Amtrak ที่ออกจากซานโฮเซ รัฐแคลิฟอร์เนีย เวลา 15:10 น. ในวันธรรมดาเพื่อไปยังแซคราเมนโต รัฐแคลิฟอร์เนีย

DirectionsTransitStop

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ LatLngLiteral

ตำแหน่งของป้ายจอดรถ

ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral
ต้องระบุ สตริง

ชื่อป้ายจอดรถ

TimeZoneTextValueObject

ออบเจ็กต์ที่มีเวลา Unix Epoch, เขตเวลา และการแสดงข้อความที่จัดรูปแบบ

ช่อง ต้องระบุ ประเภท คำอธิบาย

text

ต้องระบุ สตริง

เวลาที่ระบุเป็นสตริงในเขตเวลา
ต้องระบุ สตริง

มีเขตเวลา ค่าคือชื่อของเขตเวลาตามที่ระบุไว้ในฐานข้อมูลเขตเวลา IANA เช่น "America/New_York"

ต้องระบุ ตัวเลข

เวลาที่ระบุเป็นเวลา Unix Epoch หรือวินาทีนับตั้งแต่เที่ยงคืนของวันที่ 1 มกราคม 1970 UTC

DirectionsTransitLine

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ Array<DirectionsTransitAgency>

บริษัทขนส่ง (หรือหลายบริษัท) ที่ให้บริการเส้นทางขนส่งสาธารณะนี้

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsTransitAgency

ต้องระบุ สตริง

ชื่อเต็มของสายขนส่งสาธารณะนี้ เช่น "8 Avenue Local"
ไม่บังคับ สตริง

สีที่ใช้กันโดยทั่วไปในป้ายสำหรับสายนี้
ไม่บังคับ สตริง

มี URL ของไอคอนที่เชื่อมโยงกับบรรทัดนี้
ไม่บังคับ สตริง

ชื่อย่อของสายขนส่งสาธารณะนี้ โดยปกติแล้วจะเป็นหมายเลขสาย เช่น "M7" หรือ "355"

text_color

ไม่บังคับ สตริง

สีที่ใช้กันโดยทั่วไปในป้ายสำหรับสายนี้
ไม่บังคับ สตริง

มี URL ของสายขนส่งสาธารณะนี้ตามที่บริษัทขนส่งระบุไว้
ไม่บังคับ DirectionsTransitVehicle

ประเภทยานพาหนะที่ให้บริการในเส้นทางขนส่งสาธารณะนี้

ดูข้อมูลเพิ่มเติมได้ที่ DirectionsTransitVehicle

DirectionsTransitAgency

ช่อง ต้องระบุ ประเภท คำอธิบาย
ไม่บังคับ สตริง

ชื่อของบริษัทขนส่งนี้
ไม่บังคับ สตริง

หมายเลขโทรศัพท์ของบริษัทขนส่ง
ไม่บังคับ สตริง

URL ของบริษัทขนส่ง

DirectionsTransitVehicle

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ สตริง

ชื่อของยานพาหนะนี้ โดยขึ้นต้นด้วยตัวพิมพ์ใหญ่
ต้องระบุ สตริง

ประเภทของยานพาหนะที่ใช้

  • BUS - รถประจำทาง
  • CABLE_CAR - ยานพาหนะที่ขับเคลื่อนด้วยสายเคเบิล ซึ่งมักจะอยู่บนพื้นดิน กระเช้าลอยฟ้าอาจเป็นประเภท GONDOLA_LIFT
  • COMMUTER_TRAIN - รถไฟชานเมือง
  • FERRY - เรือข้ามฟาก
  • FUNICULAR - ยานพาหนะที่ถูกดึงขึ้นทางลาดชันด้วยสายเคเบิล โดยปกติแล้วรถรางไฟฟ้าจะประกอบด้วยรถ 2 คัน โดยรถแต่ละคันจะทำหน้าที่เป็นตัวถ่วงน้ำหนักซึ่งกันและกัน
  • GONDOLA_LIFT - กระเช้าลอยฟ้า
  • HEAVY_RAIL - รถไฟทั่วไป
  • HIGH_SPEED_TRAIN - รถไฟความเร็วสูง
  • INTERCITY_BUS - รถบัสทางไกล
  • LONG_DISTANCE_TRAIN - รถไฟทางไกล
  • METRO_RAIL - รถไฟฟ้ารางเบา
  • MONORAIL - รถไฟรางเดี่ยว
  • OTHER - ยานพาหนะอื่นๆ ทั้งหมดจะแสดงผลประเภทนี้
  • RAIL - Rail.
  • SHARE_TAXI - รถตู้โดยสารเป็นรถโดยสารประเภทหนึ่งที่สามารถรับส่งผู้โดยสารได้ทุกที่ตลอดเส้นทาง
  • SUBWAY - รถไฟฟ้ารางเบาใต้ดิน
  • TRAM - รถไฟฟ้ารางเบาบนดิน
  • TROLLEYBUS - รถรางไฟฟ้า
The allowed values include: BUS, CABLE_CAR, COMMUTER_TRAIN, FERRY, FUNICULAR, GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN, INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL, MONORAIL, OTHER, RAIL, SHARE_TAXI, SUBWAY, TRAM, and TROLLEYBUS
ไม่บังคับ สตริง

มี URL สำหรับไอคอนที่เชื่อมโยงกับประเภทยานพาหนะนี้
ไม่บังคับ สตริง

มี URL ของไอคอนที่เชื่อมโยงกับประเภทยานพาหนะนี้ โดยอิงตามป้ายการขนส่งในพื้นที่

DirectionsTrafficSpeedEntry

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ ตัวเลข

ออฟเซ็ตตามเส้นทาง (เป็นเมตร) ที่หมวดหมู่ความเร็วนี้ใช้ได้
ต้องระบุ สตริง

สภาพการจราจร/ความเร็วปัจจุบันในส่วนนี้ของเส้นทาง

DirectionsViaWaypoint

ช่อง ต้องระบุ ประเภท คำอธิบาย
ไม่บังคับ LatLngLiteral

ตำแหน่งของจุดอ้างอิง

ดูข้อมูลเพิ่มเติมได้ที่ LatLngLiteral
ไม่บังคับ จำนวนเต็ม

ดัชนีของขั้นตอนที่มีจุดอ้างอิง
ไม่บังคับ ตัวเลข

ตำแหน่งของจุดอ้างอิงตามเส้นประกอบของขั้นตอน ซึ่งแสดงเป็นอัตราส่วนตั้งแต่ 0 ถึง 1

ค่าโดยสาร

ค่าโดยสารรวมสำหรับเส้นทาง

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}
ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ สตริง

รหัสสกุลเงิน ISO 4217 ที่ระบุสกุลเงินที่ใช้แสดงจำนวนเงิน

text

ต้องระบุ สตริง

จำนวนค่าโดยสารทั้งหมดที่จัดรูปแบบเป็นภาษาที่ขอ
ต้องระบุ ตัวเลข

จำนวนค่าโดยสารทั้งหมดในสกุลเงินที่ระบุ

DirectionsStatus

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

  • OK บ่งชี้ว่าการตอบกลับมีผลลัพธ์ที่ถูกต้อง
  • NOT_FOUND บ่งชี้ว่าไม่สามารถเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ตั้งอย่างน้อย 1 แห่งที่ระบุในต้นทาง ปลายทาง หรือจุดอ้างอิงของคำขอได้
  • ZERO_RESULTS บ่งชี้ว่าไม่พบเส้นทางระหว่างต้นทางและปลายทาง
  • MAX_WAYPOINTS_EXCEEDED บ่งชี้ว่ามีการระบุจุดอ้างอิงมากเกินไปในคำขอ สำหรับแอปพลิเคชันที่ใช้ Directions API เป็นเว็บเซอร์วิสหรือบริการเส้นทางใน Maps JavaScript API จำนวนจุดอ้างอิงสูงสุดที่อนุญาตคือ 25 จุด บวกกับจุดเริ่มต้นและจุดหมาย
  • MAX_ROUTE_LENGTH_EXCEEDED บ่งชี้ว่าเส้นทางที่ขอมีความยาวเกินไปและไม่สามารถประมวลผลได้ ข้อผิดพลาดนี้จะเกิดขึ้นเมื่อระบบแสดงเส้นทางที่ซับซ้อนมากขึ้น ลองลดจำนวนจุดอ้างอิง การเลี้ยว หรือคำสั่ง
  • INVALID_REQUEST บ่งชี้ว่าคำขอที่ระบุไม่ถูกต้อง สาเหตุที่พบบ่อยของสถานะนี้ ได้แก่ พารามิเตอร์หรือค่าพารามิเตอร์ไม่ถูกต้อง
  • OVER_DAILY_LIMIT บ่งบอกถึงสิ่งใดสิ่งหนึ่งต่อไปนี้
    • ไม่มีคีย์ API หรือคีย์ API ไม่ถูกต้อง
    • ยังไม่ได้เปิดใช้การเรียกเก็บเงินในบัญชีของคุณ
    • เกินขีดจำกัดการใช้งานที่กำหนดเอง
    • วิธีการชำระเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ)
    ดูคำถามที่พบบ่อยเกี่ยวกับ Maps เพื่อดูวิธีแก้ไขปัญหานี้
  • OVER_QUERY_LIMIT บ่งชี้ว่าบริการได้รับคำขอจากแอปพลิเคชันของคุณมากเกินไปภายในระยะเวลาที่อนุญาต
  • REQUEST_DENIED บ่งชี้ว่าบริการปฏิเสธการใช้บริการเส้นทางโดยแอปพลิเคชันของคุณ
  • UNKNOWN_ERROR บ่งชี้ว่าไม่สามารถประมวลผลคำขอเส้นทางได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง

DirectionsGeocodedWaypoint

ช่อง ต้องระบุ ประเภท คำอธิบาย
ไม่บังคับ สตริง

ระบุรหัสสถานะที่ได้จากการดำเนินการเข้ารหัสพิกัดภูมิศาสตร์ ช่องนี้อาจมีค่าต่อไปนี้

The allowed values include: OK, and ZERO_RESULTS
ไม่บังคับ

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

การจับคู่บางส่วนมักเกิดขึ้นกับที่อยู่ซึ่งไม่มีอยู่ในท้องถิ่นที่คุณส่งมาในคำขอ ระบบอาจแสดงผลการจับคู่บางส่วนด้วยเมื่อคำขอตรงกับสถานที่ตั้ง 2 แห่งขึ้นไปในท้องถิ่นเดียวกัน เช่น "21 Henr St, Bristol, UK" จะแสดงผลการจับคู่บางส่วนสำหรับทั้ง Henry Street และ Henrietta Street โปรดทราบว่าหากคำขอมีองค์ประกอบที่อยู่ซึ่งสะกดผิด บริการเข้ารหัสพิกัดภูมิศาสตร์อาจแนะนำที่อยู่อื่น คำแนะนำที่ทริกเกอร์ด้วยวิธีนี้จะได้รับการทำเครื่องหมายว่าเป็นการจับคู่บางส่วนด้วย

ไม่บังคับ สตริง

ตัวระบุที่ไม่ซ้ำกันซึ่งใช้กับ Google API อื่นๆ ได้ ดูภาพรวมรหัสสถานที่

ไม่บังคับ Array<string>

ระบุประเภทที่อยู่ของผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์ที่ใช้ในการคำนวณเส้นทาง

  • administrative_area_level_1 หมายถึงหน่วยงานพลเรือนระดับที่ 1 ที่ต่ำกว่าระดับประเทศ ในสหรัฐอเมริกา การบริหารระดับเหล่านี้คือรัฐ บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ ในกรณีส่วนใหญ่ ชื่อย่อของ administrative_area_level_1 จะตรงกับเขตย่อย ISO 3166-2 และรายการอื่นๆ ที่เผยแพร่อย่างกว้างขวาง แต่ก็ไม่รับประกันว่าจะเป็นเช่นนั้น เนื่องจากผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์ของเราอิงตามสัญญาณและข้อมูลตำแหน่งที่หลากหลาย
  • administrative_area_level_2 หมายถึงหน่วยงานพลเรือนระดับที่ 2 ที่ต่ำกว่าระดับประเทศ ในสหรัฐอเมริกา การบริหารระดับเหล่านี้คือเคาน์ตี บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
  • administrative_area_level_3 หมายถึงหน่วยงานพลเรือนระดับที่ 3 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
  • administrative_area_level_4 หมายถึงหน่วยงานพลเรือนระดับที่ 4 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
  • administrative_area_level_5 หมายถึงหน่วยงานพลเรือนระดับที่ 5 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุถึงเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
  • airport หมายถึงสนามบิน
  • colloquial_area ระบุชื่ออื่นที่ใช้กันโดยทั่วไปสำหรับเอนทิตี
  • country บ่งบอกถึงหน่วยงานทางการเมืองระดับชาติ และโดยทั่วไปจะเป็นประเภทลำดับสูงสุดที่โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์แสดงผล
  • intersection หมายถึงทางแยกหลัก ซึ่งมักเป็นทางแยกของถนนสายหลัก 2 สาย
  • locality หมายถึงหน่วยงานทางการเมืองของเมืองหรือเทศบาลที่จัดตั้งขึ้น
  • natural_feature บ่งบอกถึงลักษณะทางธรรมชาติที่โดดเด่น
  • neighborhood หมายถึงย่านใกล้เคียงที่มีชื่อ
  • park หมายถึงสวนสาธารณะที่มีชื่อ
  • plus_code หมายถึงการอ้างอิงตำแหน่งที่เข้ารหัส ซึ่งได้มาจากละติจูดและลองจิจูด Plus Codes สามารถใช้แทนที่อยู่ถนนในสถานที่ที่ไม่มีที่อยู่ (อาคารไม่มีหมายเลขหรือถนนไม่มีชื่อ) ดูรายละเอียดได้ที่ https://plus.codes
  • point_of_interest ระบุจุดที่น่าสนใจที่มีชื่อ โดยปกติแล้ว "POI" เหล่านี้จะเป็นสถานที่ตั้งที่โดดเด่นในท้องถิ่นซึ่งไม่เข้ากับหมวดหมู่อื่นๆ เช่น "ตึกเอ็มไพร์สเตต" หรือ "หอไอเฟล"
  • political หมายถึงหน่วยงานทางการเมือง โดยปกติแล้ว ประเภทนี้จะระบุรูปหลายเหลี่ยมของการปกครองพลเรือนบางประเภท
  • postal_code ระบุรหัสไปรษณีย์ที่ใช้ในการจ่าหน้าจดหมายภายในประเทศ
  • premise บ่งบอกถึงสถานที่ที่มีชื่อ โดยปกติจะเป็นอาคารหรือกลุ่มอาคารที่มีชื่อร่วมกัน
  • route ระบุเส้นทางที่มีชื่อ (เช่น "US 101")
  • street_address หมายถึงที่อยู่ที่แน่นอน
  • sublocality หมายถึงหน่วยงานพลเรือนลำดับแรกที่อยู่ต่ำกว่าท้องถิ่น บางสถานที่อาจได้รับประเภทเพิ่มเติมอย่างใดอย่างหนึ่งต่อไปนี้ sublocality_level_1 ถึง sublocality_level_5 ระดับท้องถิ่นย่อยแต่ละระดับเป็นหน่วยงานพลเรือน ตัวเลขที่สูงขึ้นหมายถึงพื้นที่ทางภูมิศาสตร์ที่เล็กลง
  • subpremise หมายถึงเอนทิตีลำดับแรกที่อยู่ใต้สถานที่ที่มีชื่อ ซึ่งมักจะเป็นอาคารเดี่ยวภายในกลุ่มอาคารที่มีชื่อร่วมกัน
  • tourist_attraction หมายถึงสถานที่ท่องเที่ยว
  • train_station หมายถึงสถานีรถไฟ
  • transit_station หมายถึงสถานีขนส่ง

รายการประเภทที่ว่างเปล่าบ่งชี้ว่าไม่มีประเภทที่รู้จักสำหรับคอมโพเนนต์ที่อยู่หนึ่งๆ เช่น Lieu-dit ในฝรั่งเศส