İşletme Profili API'leriyle, satıcılarınızın işletmelerini Google'da yönetecekleri bir platform oluşturabilirsiniz. Platformunuzda iş ortaklarınızın, işletmelerinin adı, adresi ve telefon verileriyle eşleşen girişleri aramasına izin verebilirsiniz. Bir konum sahipliğini belirleyebilir ve işletmenin fiziksel konumunu enlem ve boylama göre doğru şekilde yerleştirebilir.
Başlamadan önce
İşletme Profili API'lerini kullanmadan önce uygulamanızı kaydettirmeniz ve OAuth 2.0 kimlik bilgilerini almanız gerekir. İşletme Profili API'lerini kullanmaya başlama hakkında ayrıntılı bilgi için Temel kurulum başlıklı makaleyi inceleyin.
Adres verileriyle nasıl çalışılır?
Platformunuzda adres ve coğrafi konum verileriyle çalışmak için iki farklı API ve kaynak kümesi kullanabilirsiniz: Business Profile API ve Maps API.
Yaygın olarak kullanılan İşletme Profili kaynakları
GoogleLocations
API, satıcının İşletme Profili'nde bir konum için hak talebinde bulunulup bulunulmadığını önceden görmesini sağlar. Aksi takdirde, satıcı ilgili öğe için hemen erişim isteğinde bulunabilir.
PostalAddress
nesnesi, bir işletmenin fiziksel adresini temsil eder.
Yaygın olarak kullanılan Google Haritalar kaynakları
Haritalar JavaScript Yerler Widget'ları, iş ortağı iş akışlarında etkileşimli bir harita oluşturmak için yaygın olarak kullanılır. Ek olarak, aşağıdaki Haritalar API'leri de yararlıdır:
- Otomatik Yer Tamamlama ve Yer Ayrıntıları özellikleriyle yer tahminleri döndürme. Fiyatlandırma ayrıntıları için SKU: Otomatik Tamamlama (Yer Ayrıntıları dahil) - Oturum Başına bölümüne bakın.
- Rehber Arama ile yer bilgilerini sorgulayın. Fiyatlandırma ayrıntıları için SKU: Yer Bulma bölümüne bakın.
- Coğrafi Kodlama ile adreslerin coğrafi kodlamasını ve ters coğrafi kodlamasını sağlayın. Fiyatlandırma ayrıntıları için SKU: Coğrafi Kodlama bölümüne bakın.
Bir veya sıfır eşleşme
Bir iş ortağı, bir konum için eşleşen girişleri aradığında arama sonuçlarını bir veya sıfır eşleşmeyle daraltmak olur. Bu durum, konumun arama ölçütlerine uygun olduğu veya henüz İşletme Profili'nde bulunmadığı anlamına gelir.
Bir veya hiç eşleşme olduğunda yeni bir giriş oluşturmak için accounts.locations.create
yöntemini kullanın ya da mevcut girişin sahipliğini talep etmek için GoogleLocations
kılavuzunu uygulayın. Google adresin coğrafi kodunu belirleyemiyorsa konum oluşturma işlemi başarısız olur ve API yanıtı, LatLng
verileri için bir istek içerir. Satıcının LatLng
verilerini nasıl sağlayabileceği hakkında bilgi için Coğrafi konum verilerini manuel olarak düzenleme başlıklı makaleyi inceleyin.
LatLng
koordinatları belirlendikten sonra yeni giriş oluşturulur.
Kısmi ve birden çok eşleşme
Bir işletme sahibi veya iş ortağının operasyon ekibi bir konumla eşleşen girişleri aradığında, girilen bilgiler yalnızca kısmi bir eşleşmeyle sonuçlanabilir veya arama sorgusuyla birden fazla eşleşme gelebilir. Arama sonuçlarını bir veya sıfır eşleşme olacak şekilde daraltmak için kısmi ve çoklu eşleşmeler iki Maps API kullanım alanı tarafından manuel olarak çözümlenir.
Kullanıcı aramasını hassaslaştırır
İş ortağı platformunun bir kullanıcısı bir konum aradığında ve birden fazla kısmi eşleşmeyle karşılaştığında, sorunu aşağıdaki yöntemlerden biriyle çözebilir:
- Kısmi eşleşen adresleri analiz edin ve doğru adresi seçin.
- Daha doğru olması için adresin bazı bölümlerini düzenleyin veya yeniden yazın ve sonuçlarını bir veya sıfır eşleşmeyle daraltın.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=6&hl=tr)
Kullanıcı bir veya daha fazla tam eşleşme arasından seçim yapar
Bazı durumlarda, kullanıcının arama adresiyle birden fazla konum tam olarak eşleşebilir. Örneğin, bir kullanıcı iş ortağı platformuna aşağıdaki adresi girebilir:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Hepsi belirtilen adresle eşleşen aşağıdaki yanıtların döndürüldüğünü varsayalım:
- Kasperson Printer Center, doğrulanmamış bir konumdur.
- Bengo Seguro, doğrulanmış bir konum.
- Garush Productions, doğrulanmamış bir konumdur.
Kullanıcının eşleşen işletmeyi manuel olarak seçmesi gerekir. Tüketicilere işletmenin yol tarifinin doğru olmasını sağlamak için bu konumlara ait enlem ve boylam (LatLng
) verilerinin, daha yüksek doğruluk sağlayacak şekilde ayarlanması gerekebilir. Kullanıcıların LatLng
bilgilerini manuel olarak nasıl girebilecekleri hakkında bilgi edinmek için Coğrafi konum verilerini manuel olarak düzenleme başlıklı makaleyi inceleyin.
Coğrafi konum verilerini manuel olarak düzenleme
İşletmeler, İşletme Profili'ndeki girişlerinin doğruluğunu artırmak için işletmelerinin enlem ve boylam (LatLng
) koordinatlarını ekleyebilir. Yeni işletmeler LatLng
koordinatlarını bilmiyor olabilirler. Bu nedenle, doğru LatLng
koordinatlarını belirlemek için Haritalar JavaScript Yerler Widget'ı ile manuel olarak raptiye bırakabilirler.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=6&hl=tr)
LatLng
koordinatlarıyla doğru şekilde ilişkilendirmek için her konumun koordinatlarının manuel olarak ayarlanması gerekir.Arama sonuçlarının kalitesi
Arama sonuçları, aranan adresin doğruluğuna ve coğrafi bölgeye göre büyük ölçüde değişiklik gösterir. Gelişmekte olan bölgelerde genellikle daha az Haritalar yeri gösterilir ve Google adres biçimleriyle uyumsuzluk durumu ortaya çıkar. Bu durum, arama sonuçlarının kalitesinin düşmesine ve manuel adres biçimlendirmesi ile Maps API kullanımına duyulan ihtiyacın artmasına yol açar.