Genel bakış
Google Haritalar Platformu; web (JS, TS), Android ve iOS'te kullanılabilir. Ayrıca yerler, yol tarifleri ve mesafeler hakkında bilgi edinmek için web hizmetleri API'leri sunar. Bu kılavuzdaki örnekler bir platform için yazılmıştır ancak diğer platformlarda uygulanması için belge bağlantıları sağlanmıştır.
"Sağlam Ev Ürünleri" gibi satıcı adları yerine "ACMEHCORP" gibi kısaltmalar kullanılması, işlem özetlerini genellikle kullanıcıların anlamasını zorlaştırır. Bu durum, müşteri desteği aramalarının artmasına ve pahalı itirazlara neden olabilir. Zenginleştirilmiş İşlemler, bu işlemleri basitleştirir ve satıcının tam adı ile işletme kategorisini, vitrinin fotoğrafını, haritada adresi ile konumunu, tam iletişim bilgilerini ve daha fazlasını sağlayarak işlemleri kolaylaştırır. Bu, kullanıcı memnuniyeti ve şeffaflığının artmasına yardımcı olur. Ayrıca müşteri desteği çağrılarının azaltılmasına, NPS'nin artırılmasına ve uygulama içinde daha fazla zaman geçirilebilmesine yardımcı olur.
Bu konuda sağladığımız uygulama kılavuzu ve özelleştirme ipuçları olan Zenginleştirilmiş İşlemler, mükemmel işlem geçmişi kullanıcı deneyimleri oluşturmak için Google Haritalar Platformu API'lerinin ideal kombinasyonu olarak bunu öneriyoruz. Bu uygulama kılavuzu, bir konumu belirli bir satıcıyla nasıl eşleştireceğinizi ve ayrıntılı bilgilerini gösterir.
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üler, seçtiğiniz projede her bir API'yi etkinleştirmek için sizi Google Cloud Console'a yönlendirir:
- Yerler API'si.
- Geocoding API.
- Haritalar Statik API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sı.
Uygulama kılavuzu bölümleri
Aşağıda, bu konuda ele alacağımız uygulama ve özelleştirme işlemleri belirtilmiştir.
- Onay işareti simgesi, temel uygulama adımlarından biridir.
- Yıldız simgesi isteğe bağlı olsa da çözümü iyileştirmek için önerilen bir özelleştirme seçeneğidir.
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österme | Kullanıcıların işlemi hızla tanıyabilmesi için satıcı hakkında faydalı bilgiler gösteren, veri açısından zengin işlemler gösterin. | |
Satıcının bulunduğu konumun haritasını ekleme | Satıcının bulunduğu konumun haritasını ekleyin. |
Satıcıları Google Haritalar Platformu ile eşleştirme
Bu örnekte şu kullanımlar kullanılmıştır: Places API |
Aşağıdaki şemada, mevcut satıcı veritabanındaki Yer Ayrıntılarını kullanarak veya Yer Arama isteği aracılığıyla uygulamanızın satıcı işlemleriyle nasıl eşleştiği gösterilmektedir:
Google Haritalar Platformu yer kimliklerini alma
İşletme adı ve adresi gibi temel bilgileri içeren bir satıcı veritabanınız olabilir. İletişim bilgileri ve kullanıcıların katkıda bulunduğu bilgiler dahil olmak üzere Google Haritalar Platformu'nun söz konusu yer hakkında sahip olduğu bilgileri almak için veritabanınızdaki her bir satıcıya 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 istek gönderin 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ını ve şehri kullanarak Google Taipei ofisi için yer kimliği istemeyle ilgili 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ğindeki giriş parametresini URL olarak kodladığınızdan emin olun.
Yer kimliklerini depolama
Google Haritalar Platformu'ndan gelecekteki istekler için satıcıyla ilgili bilgileri depolamak amacıyla bu yer kimliğini satıcı kaydının bir özelliği olarak veritabanınızda süresiz olarak saklayabilirsiniz. Yer Bulma isteğini satıcı başına yalnızca bir kez yapmanız gerekir. Bir kullanıcı işlem ayrıntılarını her istediğinde yer kimliğini de arayabilirsiniz.
Her zaman en doğru bilgilere sahip olduğunuzdan emin olmak için place_id
parametresiyle bir Yer Ayrıntıları isteği kullanarak 12 ayda bir Yer Kimliklerini yenileyin.
Gösterdiğiniz Yer Ayrıntılarının, işlemi yaptığı satıcıyla eşleşmemesi durumunda, kullanıcılara satıcı eşleşmesinin kalitesi hakkında geri bildirim verme izni vermenizi öneririz.
Satıcı bilgileri gösteriliyor
Bu örnekte şu kullanımlar kullanılmıştır: Places API | Ayrıca kullanılabilir: Android için Yerler SDK'sı | iOS için Yerler SDK'sı | Yer Kitaplığı, Maps JavaScript API |
Konumlarınızdan birini ziyaret eden kullanıcıların 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 yaptıkları işlemleri hatırlatabilir. Yer Ayrıntılarını almak için Yerler API'sine çağrı yaptıktan sonra yanıtı bir bilgi penceresinde, web kenar çubuğunda veya istediğiniz başka bir şekilde filtreleyebilir ve oluşturabilirsiniz.
Yer Ayrıntılarını istemek için konumlarınızın her birinin yer kimliğine ihtiyacınız vardır. Konumunuzun yer kimliğini almak için Yer kimlikleri alma konusuna bakın.
Aşağıdaki Yer Ayrıntıları isteği, Google Taipei 101 yer kimliği için json
çıkışında adres, koordinatları, web sitesini, telefon numarasını, derecelendirmeyi ve saatleri 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ının bulunduğu konumun haritasını ekleme
Bu örnekte kullanım alanları: Geocoding API | Maps Static API | Diğer ürünler: Android | iOS |
Satıcının konumunu belirleme
Maps Static API, işaretçi yerleştirmek için adres veya koordinatları kabul eder. Satıcı kaydınızda zaten bir adres varsa sonraki bölüme atlayabilirsiniz. Ancak harita doğruluğu için adreslerin üzerinde koordinatları kullanmanızı öneririz.
Satıcı veritabanınızda açık adresler bulunuyor ancak coğrafi koordinatlar bulunmuyorsa ve halihazırda Yer Ayrıntıları isteğinde bulunmuyorsanız açık adreslerinizi sunucu tarafındaki enlem/boylam koordinatlarına dönüştürmek, koordinatları veritabanınızda saklamak ve koordinatları en az 30 günde bir yenilemek için Coğrafi Kodlama API'sini kullanabilirsiniz.
Google Taipei ofis yeri kimliğinin enlem ve boylamını almak için Geocoding API'nin kullanılmasına dair bir örneği aşağıda bulabilirsiniz:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
Haritaya satıcı konumu için işaretçi ekleme
Kullanıcılarınız haritayı göz atmak veya gezinmek yerine işlemleri onaylamak için göreceğinden, etkileşimi sınırlı bir harita oluşturmak istiyorsunuz.
Masaüstü ve mobil web için satıcının enlem/boylam veya adresinde tek bir işaretçiye sahip Haritalar 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 için bir sonraki Mobil uygulamanıza harita ekleme bölümüne geçin.
Aşağıdaki çağrıda, Google Taipei ofisindeki bir işaretçinin merkezinde, varsayılan yakınlaştırma düzeyinde 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 | boyut=640x480 |
Satıcı konum işaretçileri (URL kodlaması kullanılır.) | işaretçiler=renk:kırmızı%7C25.033976%2C121.5645389 |
Bulut tabanlı harita stili | map_id=b224095f76859890 |
API Anahtarı | key=YOUR_API_KEY |
Dijital imza (İsteğinizi dijital olarak imzalama hakkında bilgi edinin.) | imza=BASE64_SIGNATURE |
Çözüm kanalı parametresi (Parametre belgelerine bakın.) | solution_channel=GMP_guides_enrichedtransactions_v1_a |
Bu, aşağıda gösterildiği gibi resim haline gelir:
İşaretçi konumu olarak da bir adresi 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
Ek parametre seçenekleri için Haritalar Statik 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 alınan koordinatları kullanarak bir işaretçi yerleştirebilirsiniz.
Kullanıcılarınız haritayı göz atmak veya gezinmek yerine işlemleri onaylamak için göreceğinden, etkileşimi sınırlı bir harita seçin:
- Android uygulamaları için İşaretçi içeren harita ekleme eğiticisine bakın ve sınırlı etkileşim sağlamak için basit modu etkinleştirin.
- iOS uygulamaları için İşaretçi eğiticisiyle harita ekleme ve
GMSUiSettings
işaretiyle kontrolleri ve hareketleri devre dışı bırakma konularına bakın.