Geocoding API เป็นบริการบนเว็บที่แปลงที่อยู่เป็นพิกัดและรหัสสถานที่ รวมถึงแปลงพิกัดหรือรหัสสถานที่ให้เป็นที่อยู่ นอกจากนี้ เมธอด v4 SearchDestinations ยังแสดงรายละเอียดปลายทาง เช่น ทางเข้าอาคาร จุดนำทาง โครงร่างอาคารและพื้นที่ และจุดสังเกตใกล้เคียง
Geocoding API: ข้อเท็จจริงสำคัญ
- ผลิตภัณฑ์: Geocoding API
- หมวดหมู่: สถานที่
- แพลตฟอร์ม: บริการผ่านเว็บ (REST)
- ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
- ระยะการเปิดตัว: GA
- วงจร: ใช้งานอยู่
- ภาพรวม: ภาพรวมของ Geocoding API
Geocoding API: กรณีที่ควรใช้
ใช้ Geocoding API ในกรณีต่อไปนี้
- คุณต้องแปลงที่อยู่เป็นพิกัดละติจูด/ลองจิจูดและรหัสสถานที่ในเซิร์ฟเวอร์แบ็กเอนด์
- คุณต้องมีที่อยู่หรือเขตบริหาร (เมือง รหัสไปรษณีย์) ที่แสดงสำหรับพิกัด GPS หรือรหัสสถานที่ที่รู้จัก
- คุณต้องมีทางเข้าอาคาร จุดนำทางที่กำหนดเส้นทางได้ หรือโครงร่างอาคาร/พื้นที่เพื่อนำทางคนขับหรือผู้จัดส่งไปยังจุดหมาย
- คุณต้องระบุจุดหมายภายในอาคารขนาดใหญ่ (สนามบิน ห้างสรรพสินค้า วิทยาเขต) เป็นจุดหมายย่อยหรือจุดสังเกตใกล้เคียง
อย่าใช้ Geocoding API ในกรณีต่อไปนี้
- คุณต้องใช้การเข้ารหัสพิกัดภูมิศาสตร์จาก JavaScript ของเบราว์เซอร์ฝั่งไคลเอ็นต์ การเรียกใช้ v4 ด้วยคีย์ API ที่เปิดเผยถือเป็นความเสี่ยงด้านความปลอดภัย โปรดใช้ Maps JavaScript API แทน
- คุณต้องคำนวณเส้นทางหรือเวลาถึงโดยประมาณไปยังปลายทางที่เข้ารหัสพิกัดภูมิศาสตร์ โปรดใช้ Routes API แทน
- คุณต้องการคำแนะนำแบบเลี้ยวต่อเลี้ยวไปยังโทเค็นจุดนำทางในแอป Android ให้ใช้ Navigation SDK สำหรับ Android แทน
- คุณต้องการคำแนะนำแบบเลี้ยวต่อเลี้ยวไปยังโทเค็นจุดนำทางในแอป iOS ให้ใช้ Navigation SDK สำหรับ iOS แทน
Geocoding API: การตั้งค่า
- บริการที่ต้องเปิดใช้:
geocoding-backend.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API, OAuth 2.0, บัญชีบริการ
- เริ่มต้นใช้งาน: ตั้งค่า Geocoding API
- ข้อมูลอ้างอิง: เอกสารอ้างอิง Geocoding API
- ราคา: การใช้งานและการเรียกเก็บเงินของ Geocoding API
- นโยบาย: นโยบาย Geocoding API
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Geocoding API
Geocoding API: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Routes API, Navigation SDK สำหรับ Android, Navigation SDK สำหรับ iOS
Geocoding API: ข้อผิดพลาดที่พบบ่อย
- ปัญหา: คำขอ
SearchDestinationsที่ไม่มีฟิลด์มาสก์จะดำเนินการไม่สำเร็จและแสดงข้อผิดพลาด ฟิลด์มาสก์เป็นฟิลด์ที่จำเป็น ซึ่งแตกต่างจากGeocodeAddress,GeocodeLocationและGeocodePlaceวิธีแก้ไข: ตั้งค่าส่วนหัวX-Goog-FieldMaskหรือพารามิเตอร์$fieldsในคำขอSearchDestinationsทุกรายการ ดู /maps/documentation/geocoding/choose-fields - ปัญหา: v4
GeocodeAddressไม่มีตัวกรองคอมโพเนนต์แบบเข้มงวด (v3components=country:US) พารามิเตอร์address.*ที่มีโครงสร้างจะรวมเป็นที่อยู่เดียวและไม่กรองผลลัพธ์ นอกจากนี้regionCodeยังไม่มีค่าเริ่มต้นใน v4 (v3 มีค่าเริ่มต้นเป็นus) วิธีแก้ไข: กรองresultsฝั่งไคลเอ็นต์: จับคู่regionCodeที่เป็นตัวพิมพ์ใหญ่กับpostalAddress.regionCodeจับคู่พื้นที่การดูแลระบบ 2 ตัวอักษรที่เป็นตัวพิมพ์ใหญ่กับpostalAddress.administrativeAreaและadministrative_area_level_naddressComponents(shortText) ปรับทั้งอินพุตและpostalAddress.postalCodeให้เป็นมาตรฐาน (ตัดช่องว่าง/ขีดกลางและใช้กฎภูมิภาค) ดู /maps/documentation/geocoding/geocoding-v4-migrate - ปัญหา: การเรียกใช้ Geocoding API v4 โดยตรงจาก JavaScript ของเบราว์เซอร์จะเปิดเผยคีย์ API และสามารถข้ามข้อจำกัดเกี่ยวกับ URL ที่มาของ HTTP ได้โดยการปลอมแปลงส่วนหัว
Refererวิธีแก้ไข: เรียกใช้ v4 จากแบ็กเอนด์ของคุณเองด้วยคีย์ที่มีการป้องกัน หรือใช้บริการการเข้ารหัสพิกัดภูมิศาสตร์ของ Maps JavaScript API (แบ็กเอนด์ v3) สำหรับความต้องการฝั่งไคลเอ็นต์ ดู /maps/documentation/geocoding/geocoding-v4-migrate - ปัญหา:
SearchDestinationsสามารถแสดงผลลัพธ์ที่ไม่มีที่อยู่หลักที่แน่นอนได้ ซึ่งแตกต่างจาก v3 และเมธอด v4 อื่นๆ วิธีแก้ไข: ตั้งค่าplaceFilter.addressabilityเป็นPRIMARYเมื่อต้องการเฉพาะผลลัพธ์ที่มีที่อยู่หลักที่แน่นอน ดู /maps/documentation/geocoding/geocoding-v4-migrate - ปัญหา: โค้ดที่เขียนสำหรับ Geocoding API v3 ไม่ทำงานในการตอบกลับ REST ของ v4 เนื่องจาก v4 ใช้ชื่อฟิลด์ lowerCamelCase (
addressComponentsไม่ใช่address_components) นำstatusและerror_messageออก และแสดงผลออบเจ็กต์รูทเดียวจากGeocodePlaceแทนอาร์เรย์resultsวิธีแก้ไข: ตรวจสอบรหัสสถานะ HTTP และเนื้อหาข้อผิดพลาดในการเรียก REST v4, อ่านฟิลด์ lowerCamelCase (addressComponents,postalAddress) และโปรดทราบว่าการตอบกลับ gRPC ยังคงใช้ snake_case ดู /maps/documentation/geocoding/geocoding-v4-migrate
Geocoding API: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว
- ข้อมูลเจาะจงเฉพาะพื้นที่ของ Geocoding API v3 (
extra_computations:BUILDING_AND_ENTRANCES,NAVIGATION_POINTS,GROUNDS; ช่องการตอบกลับbuildings.entrances,navigation_points,buildings.building_outlines,grounds): เลิกใช้งานตั้งแต่วันที่ 13-08-2025 รายการทดแทน: เมธอดSearchDestinations(POST /v4/geocode/destinations) ของ Geocoding API v4 ดูคำแนะนำในการย้ายข้อมูล
สิ่งที่คุณทำได้ด้วย Geocoding API
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- แสดงพิกัดละติจูด/ลองจิจูดของที่อยู่ (การเข้ารหัสพิกัดภูมิศาสตร์)
- แสดงผลที่อยู่สำหรับชุดพิกัดละติจูด/ลองจิจูด (การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ)
- จำกัดคำขอการเข้ารหัสพิกัดภูมิศาสตร์ให้แสดงผลลัพธ์ภายในวิวพอร์ตที่เฉพาะเจาะจง หมายเหตุ: ใน Geocoding API v4 พารามิเตอร์ locationBias จะให้น้ำหนักผลลัพธ์ตามวิวพอร์ตที่ระบุแทนที่จะจำกัดผลลัพธ์อย่างเคร่งครัด
- จำกัดคำขอการเข้ารหัสพิกัดภูมิศาสตร์หรือการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับให้แสดงผลลัพธ์ภายในภูมิภาค ประเทศ หรือรหัสไปรษณีย์ที่เฉพาะเจาะจงเท่านั้น หมายเหตุ: ใน Geocoding API v4 พารามิเตอร์ regionCode จะให้น้ำหนักผลลัพธ์ตามภูมิภาค CLDR ที่ระบุแทนที่จะจำกัดผลลัพธ์อย่างเคร่งครัด สำหรับการกรองคอมโพเนนต์ v3 เดิมตามประเทศหรือรหัสไปรษณีย์ โปรดดูที่ https://developers.google.com/maps/documentation/geocoding/guides-v3/requests-geocoding#ComponentFiltering
- จำกัดคำขอการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับให้แสดงเฉพาะผลลัพธ์สำหรับประเภทที่อยู่ที่ระบุ หมายเหตุ: ใน Geocoding API v4 พารามิเตอร์ types จะกรองผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับที่แสดงผลตามประเภทที่อยู่หลังจากการค้นหา แทนที่จะจำกัดการค้นหาที่สำคัญ
- แสดงข้อมูลเกี่ยวกับความใกล้เคียงกับจุดสังเกตหรือพื้นที่สำหรับที่อยู่
- แสดงข้อมูลเกี่ยวกับความใกล้ชิดกับจุดสังเกตหรือพื้นที่สำหรับชุดพิกัดละติจูด/ลองจิจูด
- แสดงข้อมูลเกี่ยวกับความใกล้ชิดกับจุดสังเกตหรือพื้นที่สำหรับตัวระบุสถานที่ของ Google
- แสดงผลที่อยู่สำหรับตัวระบุสถานที่ของ Google
- แสดงพิกัดละติจูด/ลองจิจูดของโครงร่างอาคารสำหรับที่อยู่
- แสดงพิกัดละติจูด/ลองจิจูดของโครงร่างอาคารสำหรับชุดพิกัดละติจูด/ลองจิจูด
- แสดงพิกัดละติจูด/ลองจิจูดของโครงร่างอาคารสำหรับตัวระบุ Google Place
- แสดงพิกัดละติจูด/ลองจิจูดของทางเข้าอาคารสำหรับที่อยู่
- แสดงพิกัดละติจูด/ลองจิจูดของทางเข้าอาคารสำหรับชุดพิกัดละติจูด/ลองจิจูด
- แสดงพิกัดละติจูด/ลองจิจูดของทางเข้าอาคารสำหรับตัวระบุ Google Place