API ของ Business Profile ช่วยให้คุณสร้างแพลตฟอร์มสำหรับผู้ขายเพื่อจัดการธุรกิจใน Google ได้ ในแพลตฟอร์ม คุณสามารถอนุญาตให้พาร์ทเนอร์ค้นหาข้อมูลที่ตรงกับชื่อ ที่อยู่ และข้อมูลโทรศัพท์ของธุรกิจได้ โดยสามารถระบุความเป็นเจ้าของสถานที่ตั้ง รวมถึงระบุสถานที่ตั้งจริงของธุรกิจได้อย่างแม่นยำตามละติจูดและลองจิจูด
ก่อนเริ่มต้น
ก่อนใช้ API ของ Business Profile คุณต้องลงทะเบียนแอปพลิเคชันและรับข้อมูลเข้าสู่ระบบ OAuth 2.0 ดูรายละเอียดเกี่ยวกับวิธีเริ่มต้นใช้งาน API ของ Business Profile ได้ที่การตั้งค่าพื้นฐาน
วิธีทำงานกับข้อมูลที่อยู่
หากต้องการทำงานกับข้อมูลที่อยู่และตำแหน่งทางภูมิศาสตร์บนแพลตฟอร์ม คุณอาจใช้ API และแหล่งข้อมูล 2 ชุดที่แตกต่างกัน ได้แก่ API ของ Business Profile และ Maps API
แหล่งข้อมูล Business Profile ที่ใช้กันโดยทั่วไป
GoogleLocations API ช่วยให้ผู้ขายทราบล่วงหน้าว่ามีการอ้างสิทธิ์สถานที่ตั้งใน Business Profile แล้วหรือยัง หากไม่เป็นเช่นนั้น ระบบจะอนุญาตให้ผู้ขายขอสิทธิ์เข้าถึงได้ทันที
ออบเจ็กต์ PostalAddress แสดงที่อยู่จริงของธุรกิจ
แหล่งข้อมูล Google Maps ที่ใช้กันโดยทั่วไป
วิดเจ็ตสถานที่ของ Maps JavaScript ใช้กันโดยทั่วไปในเวิร์กโฟลว์ของพาร์ทเนอร์เพื่อสร้างแผนที่แบบอินเทอร์แอกทีฟ นอกจากนี้ Maps API ต่อไปนี้ยังมีประโยชน์ด้วย
- แสดงผลการคาดคะเนสถานที่ด้วยการเติมสถานที่อัตโนมัติและรายละเอียดสถานที่ ดูรายละเอียดราคาได้ที่ SKU: การเติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) - ต่อเซสชัน
- ค้นหาข้อมูลสถานที่ด้วยการค้นหาสถานที่ ดูรายละเอียดราคาได้ที่ SKU: ค้นหาสถานที่
- ระบุการเข้ารหัสพิกัดภูมิศาสตร์และการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับของที่อยู่ด้วย Geocoding ดูรายละเอียดราคาได้ที่SKU: การเข้ารหัสพิกัดภูมิศาสตร์
ตรงกัน 1 รายการหรือไม่มีเลย
เมื่อพาร์ทเนอร์ค้นหาข้อมูลที่ตรงกันสำหรับสถานที่ตั้ง เป้าหมายของพาร์ทเนอร์คือการจำกัดผลการค้นหาให้เหลือข้อมูลที่ตรงกัน 1 รายการหรือไม่มีเลย ซึ่งหมายความว่าสถานที่ตั้งนั้นตรงกับเกณฑ์การค้นหาหรือยังไม่มีอยู่ใน Business Profile ตามลำดับ
ในกรณีที่มีการจับคู่ที่ตรงกัน 1 รายการหรือไม่มีเลย ให้ใช้วิธี accounts.locations.create เพื่อสร้างข้อมูลใหม่ หรือทำตามคำแนะนำ GoogleLocations เพื่ออ้างสิทธิ์การเป็นเจ้าของข้อมูลที่มีอยู่ หาก Google ไม่สามารถเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ได้ การสร้างสถานที่ตั้งจะล้มเหลวและการตอบกลับจาก API จะรวมคำขอข้อมูล LatLng ดูข้อมูลเกี่ยวกับวิธีที่ผู้ขายสามารถระบุข้อมูล LatLng ได้ที่หัวข้อการปรับข้อมูลตำแหน่งทางภูมิศาสตร์ด้วยตนเอง
เมื่อกำหนดพิกัด LatLng แล้ว ระบบจะสร้างข้อมูลใหม่
การจับคู่ที่ตรงกันบางส่วนและการจับคู่หลายรายการ
เมื่อเจ้าของธุรกิจหรือทีมปฏิบัติการของพาร์ทเนอร์ค้นหาข้อมูลที่ตรงกับสถานที่ตั้ง ข้อมูลที่พิมพ์อาจส่งผลให้เกิดการจับคู่เพียงบางส่วน หรืออาจได้รับการจับคู่หลายรายการกับคำค้นหา หากต้องการจำกัดผลการค้นหาให้แคบลงเหลือผลลัพธ์ที่ตรงกัน 1 รายการหรือไม่มีเลย กรณีการใช้งาน Maps API 2 กรณีจะแก้ไขการจับคู่บางส่วนและการจับคู่หลายรายการด้วยตนเอง
ผู้ใช้ปรับแต่งการค้นหา
เมื่อผู้ใช้แพลตฟอร์มพาร์ทเนอร์ค้นหาสถานที่ตั้งและพบกับสถานที่ตั้งที่ตรงกันบางส่วนหลายแห่ง ผู้ใช้จะแก้ไขปัญหาได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้
- วิเคราะห์ที่อยู่ที่ตรงกันบางส่วนและเลือกที่อยู่ที่ถูกต้อง
- แก้ไขหรือพิมพ์ส่วนของที่อยู่ใหม่เพื่อให้ถูกต้องมากขึ้น และจำกัดผลลัพธ์ให้เหลือรายการที่ตรงกัน 1 รายการหรือไม่มีเลย
ผู้ใช้เลือกจากรายการที่ตรงกันทั้งหมดอย่างน้อย 1 รายการ
ในบางกรณี สถานที่ตั้งหลายแห่งอาจตรงกับที่อยู่การค้นหาของผู้ใช้อย่างสมบูรณ์ ตัวอย่างเช่น ผู้ใช้อาจป้อนที่อยู่ต่อไปนี้ในแพลตฟอร์มของพาร์ทเนอร์
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
สมมติว่าระบบแสดงผลการตอบกลับต่อไปนี้ ซึ่งทั้งหมดตรงกับที่อยู่ที่ระบุ
- Kasperson Printer Center ซึ่งเป็นสถานที่ที่ไม่ได้รับการยืนยัน
- Bengo Seguro ซึ่งเป็นสถานที่ตั้งที่ได้รับการยืนยัน
- Garush Productions สถานที่ตั้งที่ยังไม่ได้รับการยืนยัน
ผู้ใช้ต้องเลือกธุรกิจที่ตรงกันด้วยตนเอง เพื่อให้มั่นใจว่าผู้บริโภคจะได้รับเส้นทางที่ถูกต้องไปยังธุรกิจ อาจต้องปรับข้อมูลละติจูดและลองจิจูด (LatLng) สำหรับสถานที่ตั้งเหล่านี้เพื่อให้มีความแม่นยำมากขึ้น ดูข้อมูลเกี่ยวกับวิธีที่ผู้ใช้สามารถป้อน LatLng ด้วยตนเองได้ที่หัวข้อการปรับข้อมูลตำแหน่งทางภูมิศาสตร์ด้วยตนเอง
การปรับข้อมูลตำแหน่งทางภูมิศาสตร์ด้วยตนเอง
ธุรกิจสามารถเพิ่มพิกัดละติจูดและลองจิจูด (LatLng) ของธุรกิจเพื่อเพิ่มความแม่นยำของข้อมูลใน Business Profile ได้ ธุรกิจใหม่อาจไม่ทราบพิกัด LatLng ของตน จึงสามารถปักหมุดด้วยตนเองแทนได้โดยใช้วิดเจ็ตสถานที่ของ Maps JavaScript เพื่อสร้างพิกัด LatLng ที่ถูกต้อง
LatLngพิกัดได้อย่างถูกต้องคุณภาพของผลการค้นหา
ผลการค้นหาจะแตกต่างกันไปอย่างมากตามความถูกต้องของที่อยู่ที่ค้นหาและตามภูมิภาคทางภูมิศาสตร์ ภูมิภาคที่กำลังพัฒนามักแสดงสถานที่ใน Maps น้อยกว่า และไม่สอดคล้องกับรูปแบบที่อยู่ของ Google ซึ่งส่งผลให้ผลการค้นหามีคุณภาพต่ำลง และเพิ่มความจำเป็นในการจัดรูปแบบที่อยู่ด้วยตนเองและการใช้ Maps API