Özel gezinme deneyimi
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Navigation SDK, uygulamanıza bir navigasyon deneyimi entegre etmenin farklı yollarını sunar. Bu sayfada, özel navigasyon deneyiminin ne olduğu ve Navigation SDK'da bulunan diğer navigasyon deneyimlerinden nasıl farklılaştığı açıklanmaktadır.
Özel gezinme deneyimi nedir?
Navigation SDK'yı uygulamanın temel yolu, Google navigasyon deneyimini kullanmaktır. Bu deneyim, Google Haritalar uygulamalarındaki navigasyon deneyimine benzer şekilde, Google tarafından sağlanan kullanıcı arayüzü öğelerini ve görselleri kullanan adım adım navigasyon deneyimini yerleştirmenize olanak tanır. Google gezinme deneyiminin sunduğundan daha fazla esnekliğe ihtiyacınız varsa özel bir gezinme deneyimi uygulayabilirsiniz.
Özel gezinme deneyimi, dönüş talimatlarını tamamen ortadan kaldırıp gezinmeyi yalnızca arka plan işlemi olarak çalıştırmaktan, gezinmenin çalıştığı cihazdan ayrı bir ekranda son derece özelleştirilmiş bir talimat deneyimi sunmaya kadar her şeyi ifade eder. Özel bir gezinme deneyimiyle uygulamanız, adım adım gezinme feed'i istemek için Navigation SDK'yı çağırır. Ardından, kullanıcının gezinme deneyiminde gördüğü kullanıcı arayüzü öğelerini ve görselleri siz sağlarsınız ve yönetirsiniz. Google navigasyon deneyimini kullanmak genellikle daha kolay olsa da kendi özel navigasyon deneyiminizi oluşturmak daha fazla özelleştirmeye olanak tanır.
Özel bir gezinme deneyimi oluşturduğunuzda uygulamanız, aşağıdaki akışı kullanarak gezinmeyi başlatmak, çalıştırmak ve durdurmak için Navigation SDK'yı çağırır:
Navigasyonu başlatın. Google rota izleme deneyiminde olduğu gibi, özel rota izleme deneyiminde de rota izleme örneği oluşturulur ve hedef ayarlanır. Ancak özelleştirilmiş bir gezinme deneyimiyle, önce GMSNavigationService.createNavigationSession kullanarak bir gezinme oturumu oluşturarak bunu başarırsınız. Bu, bir görünüm denetleyicisiyle veya denetleyici olmadan çalışabilen, durum taşıyan bir kullanıcı arayüzü olmayan nesnedir.
Daha fazla bilgi için Dönüş dönüş talimatı veri feed'ini etkinleştirme başlıklı makaleyi inceleyin.
Demoyu inceleyin: Navigation SDK'sının indirme işleminde, standart navigasyon aracılığıyla adım adım yol tarifinden yalnızca cihaz konumunun bir yol çoklu çizgisi boyunca hareket ettiğini gösteren bir navigasyon deneyimine geçiş yapan bir navigasyon deneyimi örneğini görmek için çalıştırabileceğiniz bir demo bulunur.
Etkin gezinme Google tarafından sağlanan gezinme deneyimi ile özel gezinme deneyimi arasındaki bir diğer önemli farkı aşağıda bulabilirsiniz.
Yol tarifini Navigation SDK'nın yerleşik etkinlik yöneticisine aktarmak yerine adım adım yol tarifini etkinleştirir ve etkinlik işleyicileri uygularsınız. Bu, deneyiminizin Listen for navigation events (Gezinme etkinliklerini dinleme) bölümünde açıklanan etkinliklere yanıt vermesini sağlar.
Navigasyonu sonlandırın. Google gezinme deneyiminde olduğu gibi, özel gezinme de gezinmeyi uygulamanın deneyimine en uygun şekilde sonlandırmanızı gerektirir.
Özel gezinme deneyimini ne zaman kullanabilirsiniz?
Aşağıdaki tabloda bazı özel gezinme senaryoları açıklanmaktadır.
Örnek senaryo |
Kısaca adımlar |
2 tekerlekli araçlar gibi küçük cihazlar için yalnızca metin içeren sürücü talimatları sağlamanız gerekir. |
Sürücünün hemen görüş alanı dışında, sürücünün cep telefonunda navigasyon cihazını çalıştırırken navigasyon cihazınızı oluşturun ve adım adım yol tarifini küçük ekranlı bir cihaza veri feed'i olarak ayarlayın. |
Uygulamanızı, Android Auto kullanan sürücüler için bir araç hizmeti olarak sunmak istiyorsunuz. |
- Araç hizmetini ayarlayın.
- Navigation SDK projenizi oluşturun.
- Henüz yapmadıysanız bir gezgin belirleyin.
- Adım adım yol tarifi feed'ini etkinleştirin.
- Haritayı otomatik uygulama yüzeyinde çizin ve yapılandırdığınız veri feed'inden alanları doldurun.
Daha fazla bilgi için Android Auto'da Navigasyon'u etkinleştirme başlıklı makaleyi inceleyin. |
Uygulamanızı kullanan sürücüler, yolculuklarının büyük bir bölümünde genel bakış haritası görmek ve şehir sokaklarında yalnızca minimum düzeyde adım adım yol tarifi almak istiyor. |
Uygulamanız, sürücülerin navigasyon ayarlarını hedef ve gezi modu için değiştirmelerine gerek kalmadan Google navigasyon deneyimine istedikleri zaman girmelerine ve bu deneyimden çıkmalarına olanak tanımalıdır. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[[["\u003cp\u003eThe Navigation SDK offers both a pre-built Google navigation experience and the flexibility to create custom navigation experiences.\u003c/p\u003e\n"],["\u003cp\u003eCustom navigation experiences allow developers to manage UI elements, visuals, and event handling for a highly tailored user interface.\u003c/p\u003e\n"],["\u003cp\u003eThis customization ranges from background navigation to projecting guidance onto separate screens, giving developers more control.\u003c/p\u003e\n"],["\u003cp\u003eCustom experiences involve starting navigation, managing active navigation with event handlers, and ending navigation as needed.\u003c/p\u003e\n"],["\u003cp\u003eUse cases for custom navigation include text-only guidance, Android Auto integration, and dynamic switching between map views and turn-by-turn instructions.\u003c/p\u003e\n"]]],[],null,["# Custom navigation experience\n\nThe Navigation SDK provides different ways to integrate a navigation\nexperience into your app. This page explains what a custom navigation experience\nis and how it differs from other navigation experiences that are available in\nthe Navigation SDK.\n\nWhat is a custom navigation experience?\n---------------------------------------\n\nThe primary way to implement the Navigation SDK is to use the [Google\nnavigation\nexperience](/maps/documentation/navigation/android-sdk/intro-google-nav),\nwhich lets you embed a turn-by-turn navigation experience that uses\nGoogle-provided UI elements and visuals --- similar to the navigation experience\nwithin the Google Maps apps. If you need more flexibility than the Google\nnavigation experience offers, you can implement a custom navigation experience.\nA custom navigation experience refers to anything from eliminating turn guidance\nentirely with and running navigation only as a background process, to projecting\na highly customized guidance experience to a screen separate from the device\nthat runs the navigation. With a custom navigation experience, your app calls\nthe Navigation SDK to request a turn-by-turn navigation feed, and then\nyou provide and manage the UI elements and visuals that the user sees in the\nnavigation experience. While using the Google navigation experience is generally\neasier to implement, building your own custom navigation experience allows for\nmore customization.\n\nWhen you create a custom navigation experience, your app calls the Navigation\nSDK to start, run, and stop navigation, using the following flow:\n\n1. **Start navigation** . As with the Google navigation experience, a custom\n navigation experience still involves creating a navigation instance and\n setting the destination. However, with a customized navigation experience,\n you achieve this by first establishing a navigation session using\n `GMSNavigationService.createNavigationSession`, which is a state-bearing\n non-UI object that can operate either with a view controller, or without\n one.\n\n For more information, see [Enable turn-by-turn data\n feed](/maps/documentation/navigation/android-sdk/tbt-feed).\n\n **See the demo:** The download of the Navigation SDK contains a demo\n you can run to see an example of a navigation experience that switches\n between turn-by-turn guidance through standard navigation to a navigation\n experience that shows only the device location moving along a road\n polyline.\n2. **Active navigation** . Here is another key difference between a\n Google-provided navigation experience and a custom navigation experience.\n Instead of handing off guidance to the built-in event manager of the\n Navigation SDK, you enable the turn-by-turn feed and implement event\n handlers. This allows your experience to respond to the events described in\n [Listen for navigation\n events](/maps/documentation/navigation/android-sdk/events).\n\n3. **End navigation**. As with the Google navigation experience, custom\n navigation also requires you to terminate navigation in the manner best\n suited for the app's experience.\n\nWhen might you use a custom navigation experience?\n--------------------------------------------------\n\nThe following table describes some custom navigation scenarios.\n\n| **Example scenario** | **High-level steps** |\n|----------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| You need to provide text-only driver guidance for small devices such as 2-wheeled vehicles. | Create your navigator and set up the turn-by-turn guidance as a data feed to a small screen device while the navigator runs on the driver's mobile phone outside of their immediate view. |\n| You want to make your app available as a car service for drivers who use Android Auto. | 1. Set up the car service. 2. Set up your Navigation SDK project. 3. Establish a navigator if you haven't already. 4. Enable the turn-by-turn guidance feed. 5. Draw the map on the auto app surface and populate the fields from the data feed you configured. For more information, see [Enable Navigation for Android Auto](/maps/documentation/navigation/android-sdk/android-auto) |\n| Drivers using your app want an overview map for most of their journey, with only minimal turn-by-turn guidance for city streets. | Your app should allow drivers to enter and exit the Google navigation experience as they need, without alternating the navigator's settings for destination and trip mode. |"]]
