Business Profile API ช่วยให้คุณสร้างแพลตฟอร์มสำหรับผู้ขายเพื่อจัดการธุรกิจใน Google ได้ บนแพลตฟอร์ม คุณสามารถอนุญาตให้พาร์ทเนอร์ค้นหารายชื่อที่ตรงกับชื่อ ที่อยู่ และข้อมูลโทรศัพท์ของธุรกิจได้ ผู้ลงโฆษณาจะสามารถกำหนดความเป็นเจ้าของสถานที่ และช่วยวางตำแหน่งทางกายภาพของธุรกิจได้อย่างแม่นยำจากละติจูดและลองจิจูด
ก่อนเริ่มต้น
ก่อนที่จะใช้ Business Profile API คุณจะต้องลงทะเบียนแอปพลิเคชันและรับข้อมูลเข้าสู่ระบบ OAuth 2.0 ก่อน โปรดดูรายละเอียดเกี่ยวกับวิธีเริ่มต้นใช้งาน Business Profile API ที่หัวข้อการตั้งค่าพื้นฐาน
วิธีทำงานกับข้อมูลที่อยู่
คุณอาจใช้ชุด API และทรัพยากร 2 ชุดที่แตกต่างกัน ได้แก่ Business Profile API และ Maps API เพื่อจัดการกับที่อยู่และตำแหน่งทางภูมิศาสตร์ในแพลตฟอร์ม
แหล่งข้อมูล Business Profile ที่ใช้กันโดยทั่วไป
GoogleLocations
API ช่วยให้ผู้ขายเห็นล่วงหน้าหากมีการอ้างสิทธิ์ในสถานที่ตั้งใน Business Profile แล้ว แต่หากไม่มีสิทธิ์ ผู้ขายจะขอสิทธิ์เข้าถึงได้ทันที
ออบเจ็กต์ PostalAddress
เป็นตัวแทนที่อยู่จริงของธุรกิจ
แหล่งข้อมูล Google Maps ที่ใช้กันโดยทั่วไป
วิดเจ็ต Maps JavaScript Places เป็นฟีเจอร์ที่ใช้กันโดยทั่วไปในเวิร์กโฟลว์ของพาร์ทเนอร์เพื่อสร้างแผนที่แบบอินเทอร์แอกทีฟ นอกจากนี้ Maps API ต่อไปนี้ยังมีประโยชน์ดังนี้
- แสดงผลการคาดคะเนสถานที่ด้วย Place Autocomplete และ Place Details โปรดดูรายละเอียดราคาที่ SKU: เติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชัน
- ข้อความค้นหาข้อมูลสถานที่ด้วย Place Search โปรดดูรายละเอียดราคาที่ SKU: ค้นหาสถานที่
- ระบุพิกัดทางภูมิศาสตร์และการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับของที่อยู่ด้วยการระบุพิกัดทางภูมิศาสตร์ โปรดดูรายละเอียดราคาที่ SKU: การระบุพิกัดทางภูมิศาสตร์
รายการที่ตรงกัน 1 หรือ 0
เมื่อพาร์ทเนอร์ค้นหารายชื่อที่ตรงกันสำหรับสถานที่ตั้งหนึ่งๆ เป้าหมายของพวกเขาคือจำกัดผลการค้นหาให้แสดงเฉพาะผลการค้นหาที่ตรงกับคำค้นหาเพียง 1 หรือ 0 รายการ ซึ่งหมายความว่าสถานที่ตั้งนี้ตรงกับเกณฑ์การค้นหา หรือยังไม่มีสถานที่ตั้งอยู่ใน Business Profile ตามลำดับ
หากมีรายการที่ตรงกันเพียง 1 หรือ 0 รายการ ให้ใช้เมธอด accounts.locations.create
เพื่อสร้างข้อมูลใหม่ หรือทำตามคำแนะนำสำหรับ GoogleLocations
เพื่ออ้างสิทธิ์การเป็นเจ้าของข้อมูลที่มีอยู่ หาก Google ระบุพิกัดทางภูมิศาสตร์ของที่อยู่ไม่ได้ การสร้างตำแหน่งจะล้มเหลวและการตอบกลับ API จะมีคำขอข้อมูล LatLng
ดูข้อมูลเกี่ยวกับวิธีที่ผู้ขายระบุข้อมูล LatLng
ของตนได้ที่การปรับข้อมูลตำแหน่งทางภูมิศาสตร์ด้วยตนเอง
เมื่อระบุพิกัดของ LatLng
ได้แล้ว ระบบจะสร้างรายชื่อใหม่
รายการที่ตรงกันบางส่วนและหลายรายการ
เมื่อเจ้าของธุรกิจหรือทีมปฏิบัติงานของพาร์ทเนอร์ค้นหารายชื่อที่ตรงกับสถานที่ ข้อมูลที่พิมพ์อาจตรงกันเพียงบางส่วน หรืออาจได้รับข้อความที่ตรงกันหลายรายการกับข้อความค้นหาของตน หากต้องการจำกัดผลการค้นหาให้แคบลงเหลือเพียง 1 หรือ 0 รายการที่ตรงกัน ระบบจะแก้ปัญหาการจับคู่ที่ตรงกันบางส่วนและหลายรายการด้วยตนเองตามกรณีการใช้งาน Maps API 2 กรณี
ผู้ใช้ปรับแต่งการค้นหาของตน
เมื่อผู้ใช้ในแพลตฟอร์มพาร์ทเนอร์ค้นหาตำแหน่งและพบผลลัพธ์ที่ตรงกันบางส่วนหลายรายการ ผู้ใช้จะแก้ไขปัญหาได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้
- วิเคราะห์ที่อยู่ที่ตรงกันบางส่วนและเลือกที่อยู่ที่ถูกต้อง
- แก้ไขหรือพิมพ์บางส่วนของที่อยู่ซ้ำให้ถูกต้องมากขึ้น และจำกัดผลลัพธ์ให้แคบลงเหลือเพียง 1 หรือ 0 รายการที่ตรงกัน
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=19&hl=th)
ผู้ใช้เลือกจากรายการที่ตรงกันทั้งหมดอย่างน้อย 1 รายการ
ในบางกรณี สถานที่หลายแห่งอาจตรงกับที่อยู่การค้นหาของผู้ใช้ทั้งหมด ตัวอย่างเช่น ผู้ใช้อาจป้อนที่อยู่ต่อไปนี้ในแพลตฟอร์มของพาร์ทเนอร์
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
สมมติว่ามีการตอบกลับต่อไปนี้ ซึ่งทั้งหมดตรงกับที่อยู่ที่ระบุ
- ศูนย์เครื่องพิมพ์ Kasperson สถานที่ตั้งที่ไม่ได้รับการยืนยัน
- Bengo Seguro ซึ่งเป็นสถานที่ตั้งที่ยืนยันแล้ว
- Garush Productions สถานที่ตั้งที่ไม่มีการยืนยัน
ผู้ใช้จะต้องเลือกธุรกิจที่ตรงกันด้วยตนเอง เพื่อให้มั่นใจว่าผู้บริโภคจะได้รับข้อมูลเส้นทางมายังธุรกิจที่ถูกต้อง คุณอาจต้องปรับข้อมูลละติจูดและลองจิจูด (LatLng
) ของสถานที่เหล่านี้เพื่อให้ความแม่นยำสูงขึ้น ดูวิธีที่ผู้ใช้ป้อน LatLng
ด้วยตนเองได้ที่การปรับข้อมูลตำแหน่งทางภูมิศาสตร์ด้วยตนเอง
การปรับข้อมูลตำแหน่งทางภูมิศาสตร์ด้วยตนเอง
ธุรกิจเพิ่มพิกัดละติจูดและลองจิจูด (LatLng
) ของธุรกิจได้เพื่อเพิ่มความถูกต้องของข้อมูลใน Business Profile ธุรกิจใหม่ๆ อาจไม่ทราบพิกัด LatLng
ของตน จึงปักหมุดด้วยตนเองโดยใช้วิดเจ็ต Maps JavaScript Places เพื่อสร้างพิกัด LatLng
ที่ถูกต้องแทนได้
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=19&hl=th)
LatLng
ได้อย่างถูกต้องคุณภาพของผลการค้นหา
ผลการค้นหาจะแตกต่างกันไปขึ้นอยู่กับความถูกต้องของที่อยู่ที่ค้นหาและตามพื้นที่ทางภูมิศาสตร์ ภูมิภาคที่กำลังพัฒนามักแสดงสถานที่ใน Maps น้อยลง และไม่สอดคล้องกับรูปแบบที่อยู่ของ Google ซึ่งทำให้ผลการค้นหาที่มีคุณภาพต่ำลงและความต้องการในการจัดรูปแบบที่อยู่ด้วยตนเองมากขึ้น ตลอดจนการใช้ Maps API