Zenginleştirilmiş İşlemler uygulama kılavuzu

Genel Bakış

web iOS API

Google Haritalar Platformu web (JS, TS), Android ve iOS için kullanılabilir. Ayrıca yerler, yönler ve mesafeler hakkında bilgi edinmek için web hizmetleri API'leri de sunar. Bu kılavuzdaki örnekler tek bir platform için yazılmıştır ancak diğer platformlarda uygulama için doküman bağlantıları sağlanmıştır.

"Acme Ev Eşyaları" gibi satıcı adları yerine "ACMEHCORP" gibi kısaltmalar kullanılması, işlem beyanlarının kullanıcılar tarafından anlaşılmasını zorlaştırır. Bu da müşteri desteği aramalarının artmasına ve pahalı itirazlara neden olabilir. Zenginleştirilmiş İşlemler, satıcının tam adını ve işletme kategorisini, vitrinin fotoğrafını, haritadaki adresini ve konumunu, tam iletişim bilgilerini ve daha fazlasını sağlayarak bu işlemleri basitleştirir ve sezgisel hale getirir. Bu, kullanıcı memnuniyetini ve şeffaflığı artırmaya yardımcı olur. Ayrıca müşteri desteği aramalarını azaltabilir, NPS'yi artırabilir ve uygulamada daha fazla zaman geçirmeyi sağlayabilir.

Zenginleştirilmiş İşlemler (bu konuda sunduğumuz uygulama kılavuzu ve özelleştirme ipuçları), mükemmel işlem geçmişi kullanıcı deneyimleri oluşturmak için Google Haritalar Platformu API'lerinin en uygun kombinasyonu olarak önerdiğimiz yöntemdir. Bu uygulama kılavuzunda, bir konumu belirli bir satıcıyla nasıl eşleştireceğiniz ve satıcının ayrıntılı bilgilerini nasıl göstereceğiniz açıklanmaktadır.

Zenginleştirilmiş işlemler örnek ekranları
Zenginleştirilmiş işlemler örnek ekranları (büyütmek için tıklayın)

API'ler etkinleştiriliyor

Zenginleştirilmiş İşlemleri uygulamak için Google Cloud Console'da aşağıdaki API'leri etkinleştirmeniz gerekir. Aşağıdaki köprü bağlantıları, seçtiğiniz proje için her API'yi etkinleştirmek üzere sizi Google Cloud Console'a yönlendirir:

Kurulum hakkında daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Uygulama kılavuzu bölümleri

Bu konuda ele alacağımız uygulamalar ve özelleştirmeler aşağıda verilmiştir.

  • Onay işareti simgesi, temel bir uygulama adımıdır.
  • Yıldız simgesi, çözümü iyileştirmek için isteğe bağlı ancak önerilen bir özelleştirmedir.
Satıcıları Google Haritalar Platformu ile eşleştirme İşlem geçmişindeki bir satıcıyı Google Haritalar Platformu'ndaki bir yerle ilişkilendirme
Satıcı ayrıntılarını görüntüleme Kullanıcıların işlemi hızlıca tanıyabilmesi için satıcıyla ilgili yararlı bilgiler içeren, veri açısından zengin işlemler gösterin.
Satıcı konumunun haritasını ekleme Satıcının bulunduğu yerin haritasını ekleyin.

Satıcıları Google Haritalar Platformu ile eşleştirme

Bu örnekte şunlar kullanılır: Places API

Aşağıdaki şemada, uygulamanızın mevcut bir satıcı veritabanındaki yer ayrıntılarını kullanarak veya bir yer arama isteği aracılığıyla sonuç döndürmek için satıcı işlemlerini nasıl eşleştirdiği gösterilmektedir:

Satıcı eşleştirme akışı matrisi
Satıcı eşleştirme akışı matrisi (büyütmek için tıklayın)

Google Haritalar Platformu yer kimlikleri alma

İşletmenin adı ve adresi gibi temel bilgiler içeren bir satıcı veritabanınız olabilir. İletişim bilgileri ve kullanıcı tarafından eklenen bilgiler de dahil olmak üzere Google Haritalar Platformu'nun bu yerle ilgili sahip olduğu bilgileri almak için veritabanınızdaki satıcıların her birine karşılık gelen Google Haritalar Platformu yer kimliğine ihtiyacınız vardır.

Bir işletmenin yer kimliğini almak için Places API'deki /findplacefromtext uç noktasına istekte bulunun ve isteği ücretsiz bir Yer Bulma - Yalnızca Kimlik çağrısı olarak faturalandırmak için yalnızca place_id alanını isteyin. Satıcının birden fazla konumu varsa satıcı adını şehir veya sokak adıyla birlikte kullanın. Aramanın döndürdüğü verilerin kalitesi değişiklik gösterir. Bu nedenle, döndürülen sonuçların gerçekten istenen satıcıyla eşleşip eşleşmediğini doğrulamanız gerekir.

Aşağıda, satıcı adı ve şehir kullanılarak Google Taipei ofisinin yer kimliğinin istenmesine ilişkin bir örnek verilmiştir:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

API isteğinde giriş parametresini URL olarak kodladığınızdan emin olun.

Yer kimliklerini depolama

Gelecekteki istekler için Google Haritalar Platformu'ndaki satıcıyla ilgili bilgileri depolamak istiyorsanız bu yer kimliğini satıcı kaydının bir özelliği olarak veritabanınızda süresiz olarak depolayabilirsiniz. Yer bulma isteğini satıcı başına yalnızca bir kez göndermeniz gerekir. Ayrıca, bir kullanıcı her işlem ayrıntısı istediğinde yer kimliğini arayabilirsiniz.

Her zaman en doğru bilgilere sahip olmak için place_id parametresini içeren bir Yer Ayrıntıları isteği kullanarak 12 ayda bir yer kimliklerini yenileyin.

Gösterdiğiniz yer ayrıntıları, işlemi gerçekleştirdikleri satıcıyla eşleşmiyorsa kullanıcıların satıcı eşleşmesinin kalitesi hakkında geri bildirim vermesine izin vermenizi öneririz.

Satıcı ayrıntılarını gösterme

Bu örnekte şunlar kullanılır: Places API Şunları da kullanabilirsiniz: Android için Yerler SDK'sı | iOS için Yerler SDK'sı | Yerler Kitaplığı, Maps JavaScript API

Kullanıcıların konumlarınızdan birini ziyaret ettikten sonra bilmesi gereken yer ayrıntılarını paylaşabilirsiniz. İletişim bilgileri, çalışma saatleri, kullanıcı puanları ve kullanıcı fotoğrafları gibi zengin yer ayrıntıları sayesinde uygulamanız, kullanıcılara tamamladıkları işlemleri hatırlatabilir. Yer Ayrıntıları'nı almak için Places API'yi çağırdıktan sonra yanıtı bir bilgi penceresinde, web kenar çubuğunda veya Hizmet Şartlarımız'ın sınırları dahilinde istediğiniz şekilde filtreleyip oluşturabilirsiniz.

Örnek satıcı ayrıntıları ekranı
Satıcı ayrıntıları ekranı örneği (büyütmek için tıklayın)

Yer ayrıntıları isteğinde bulunmak için her konumunuzun yer kimliğine ihtiyacınız vardır. Konumunuzun yer kimliğini almak için Yer kimlikleri alma başlıklı makaleyi inceleyin.

Aşağıdaki Yer Ayrıntıları isteği, Google Taipei 101 yer kimliği için adresi, koordinatları, web sitesini, telefon numarasını, derecelendirmeyi ve çalışma saatlerini json çıktısında döndürür:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Satıcı konumunun haritasını ekleme

Bu örnekte şunlar kullanılır: Coğrafi Kodlama API'si | Maps Static API Ayrıca kullanılabilir: Android | iOS

Satıcının konumunu belirleme

Maps Static API, işaretçi yerleştirmek için bir adres veya koordinat kabul eder. Satıcı kaydınızda zaten bir adres varsa sonraki bölüme geçebilirsiniz ancak haritadaki konumun doğruluğu için adres yerine koordinatları kullanmanızı öneririz.

Satıcı veritabanınızda sokak adresleri varsa ancak coğrafi koordinatlar yoksa ve yer ayrıntılarını istemiyorsanız sokak adreslerini sunucu tarafında enlem/boylam koordinatlarına dönüştürmek, koordinatları veritabanınızda depolamak ve koordinatları en az 30 günde bir yenilemek için Coğrafi Kodlama API'yi kullanabilirsiniz.

Google Taipei ofisi yer kimliğinin enlem ve boylamını almak için Geocoding API'nin kullanıldığı örnek:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Satıcı konumu için haritaya işaretçi ekleme

Kullanıcılarınız, haritayı göz atmak veya gezinmek yerine işlemleri onaylamak için göreceğinden, sınırlı etkileşime sahip bir harita oluşturmak istersiniz.

Masaüstü ve mobil web için satıcının enlem/boylamında veya adresinde tek bir işaretçi içeren bir Maps Statik API URL'si oluşturun. Maps Static API'yi bir web hizmeti çağrısı kullanarak kullanabilirsiniz. Bu çağrı, belirttiğiniz parametrelere göre bir haritanın resim sürümünü oluşturur. Mobil cihazlar için Mobil uygulamanıza harita ekleme bölümüne atlayın.

Aşağıdaki çağrıda, varsayılan yakınlaştırma düzeyinde Google Taipei ofisindeki bir işaretçiye odaklanan 640x480 piksel boyutunda bir yol haritası gösterilmektedir. Ayrıca, kırmızı bir teslimat konumu işaretçisi ve bulut tabanlı bir harita stili de belirtir:

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Bu, aşağıdaki bölümlere ayrılır:

API URL'si https://maps.googleapis.com/maps/api/staticmap?
Resim boyutu size=640x480
Satıcı yer işaretleri (URL kodlaması kullanılarak) markers=color:red%7C25.033976%2C121.5645389
Bulut tabanlı harita stili map_id=b224095f76859890
API Anahtarı key=YOUR_API_KEY
Dijital imza (İsteğinizi dijital olarak nasıl imzalayacağınızı öğrenin) signature=BASE64_SIGNATURE
Çözüm kanalı parametresi (Parametre dokümanına bakın) solution_channel=GMP_guides_enrichedtransactions_v1_a

Bu, aşağıda gösterilen resim haline gelir:

Google Taipei Ofisi'nin statik harita resmi

İşaretçi konumu olarak bir adres de kullanabilirsiniz:

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Diğer parametre seçenekleri için Maps Static API belgelerine bakın.

Mobil uygulamanıza harita ekleme

Android için Haritalar SDK'sını veya iOS için Haritalar SDK'sını kullanıyorsanız Yer Ayrıntıları'ndaki bilgilerden koordinatları kullanarak bir işaretçi yerleştirebilirsiniz.

Kullanıcılarınız, göz atmak veya gezinmek yerine işlemleri onaylamak için haritayı göreceğinden, sınırlı etkileşime sahip bir harita seçin: