İşletme Profili API'leri ile satıcılarınızın Google'da işletmelerini yönetmeleri için 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 konumun 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 edinmeniz gerekir. Business Profile API'lerini kullanmaya başlama hakkında ayrıntılı bilgi için Temel kurulum bölümüne bakın.
Adres verileriyle çalışma
Platformunuzda adres ve coğrafi konum verileriyle çalışmak için iki farklı API ve kaynak grubu kullanabilirsiniz: İşletme Profili API'leri ve Haritalar API'si.
Yaygın olarak kullanılan İşletme Profili kaynakları
GoogleLocations
API, satıcının bir konum için İşletme Profili'nde hak talebinde bulunulup bulunulmadığını önceden görmesine olanak tanır. Aksi takdirde satıcının hemen erişim isteğinde bulunmasına izin verilir.
PostalAddress
nesnesi, bir işletmenin fiziksel adresini temsil eder.
Sık kullanılan Google Haritalar kaynakları
Haritalar JavaScript Yer Widget'ları, genellikle iş ortağı iş akışlarında etkileşimli bir harita oluşturmak için kullanılır. Ayrıca aşağıdaki Haritalar API'leri de yararlıdır:
- Otomatik Yer Tamamlama ve Yer Ayrıntıları ile yer tahminleri döndürme. Fiyatlandırma ayrıntıları için SKU: Otomatik Tamamlama (Yer Ayrıntıları dahil) – Oturum Başına başlıklı makaleyi inceleyin.
- Yer arama ile yer bilgileri için sorgu gönderin. Fiyatlandırma ayrıntıları için SKU: Yer Bul başlıklı makaleyi inceleyin.
- Coğrafi kodlama ile adreslerin coğrafi kodlamasını ve tersine coğrafi kodlamasını sağlayın. Fiyatlandırma ayrıntıları için SKU: Coğrafi kodlama başlıklı makaleyi inceleyin.
Bir veya sıfır eşleşme
Bir iş ortağı, bir konumla eşleşen girişleri ararken arama sonuçlarını bir veya sıfır eşleşmeyle sınırlandırmayı hedefler. Bu, konumun sırasıyla arama ölçütlerine uyduğu veya henüz İşletme Profili'nde bulunmadığı anlamına gelir.
Bir veya sıfır eşleşme varsa 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, adresi coğrafi kodlayamazsa 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 edinmek için Coğrafi konum verilerinin manuel olarak ayarlanması başlıklı makaleyi inceleyin.
LatLng
Koordinatları belirlendikten sonra yeni giriş oluşturulur.
Kısmi ve çoklu eşleşmeler
Bir işletme sahibi veya iş ortağının operasyon ekibi, bir konumla eşleşen girişleri aradığında, girdikleri bilgiler yalnızca kısmi bir eşleşmeyle sonuçlanabilir veya arama sorgusuyla birden fazla eşleşme alabilirler. Arama sonuçlarını bir veya sıfır eşleşmeye indirgemek için kısmi ve birden fazla eşleşme, iki Haritalar API kullanım alanı tarafından manuel olarak çözülür.
Kullanıcı aramasını hassaslaştırır
İş ortağı platformunun bir kullanıcısı bir konum aradığında birden fazla kısmi eşleşmeyle karşılaşırsa sorunu aşağıdaki yöntemlerden biriyle çözebilir:
- Kısmi eşleşen adresleri analiz edin ve doğru olanı seçin.
- Adresin bölümlerini daha doğru olacak şekilde düzenleyin veya yeniden yazın ve sonuçları bir veya sıfır eşleşmeyle sınırlayın.

Kullanıcı, bir veya daha fazla tam eşleşmeden seçim yapar
Bazı durumlarda, birden fazla konum kullanıcının arama adresiyle 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
Aşağıdaki yanıtların döndürüldüğünü ve bunların hepsinin belirtilen adresle eşleştiğini varsayalım:
- Doğrulanmamış bir konum olan Kasperson Yazıcı Merkezi.
- Doğrulanmış bir konum olan Bengo Seguro.
- Doğrulanmamış bir konum olan Garush Productions.
Kullanıcının eşleşen işletmeyi manuel olarak seçmesi gerekir. Tüketicilerin işletmeye doğru yol tarifi alabilmesi için bu konumların enlem ve boylam (LatLng
) verilerinin daha yüksek doğruluk sağlamak amacıyla ayarlanması gerekebilir. Kullanıcıların LatLng
değerini manuel olarak nasıl girebileceği hakkında bilgi edinmek için Coğrafi konum verilerinin manuel olarak ayarlanması başlıklı makaleyi inceleyin.
Coğrafi konum verilerinin manuel olarak ayarlanması
İş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 olabilir. Bu nedenle, doğru LatLng
koordinatlarını belirlemek için Haritalar JavaScript Yerler Widget'ı ile manuel olarak raptiye bırakabilirler.

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çimlerine uygunluk tutarsızdır. Bu durum, arama sonuçlarının kalitesinin düşmesine ve manuel adres biçimlendirme ve Haritalar API'sinin kullanımına olan ihtiyacın artmasına neden olur.