This document provides guidance on structure, content, and design of reference sections for the partner websites. They refer to relatively common cases of integration and based on the expertise of 2GIS specialists obtained when developing their own products, as well as on the experience with API partners.
Following the recommendations in one way or another is required so that it was possible to assign a commercial status to a partner.
As a rule, the aim of a startup page is to show users the opportunities of the service and make them “look inside”.
Depending on the type of project, this aim can be achieved in different ways. But almost in any case the following solutions will the the most effective ones.
Search it is the most popular way of interacting with information, so the search string can be as visible and large as the design of your project allows it — it will almost certainly get the well-deserved attention of users.
If the project is focused on a few cities, it is recommended to make a dropdown list of these cities using the “List of regions” method.
For services where not only reference, but also a map component is important, it is recommended to display a map. Thus a user will immediately understand the purpose of the service.
The value of the map increases if the map is clickable. This is implemented by integrating the methods of map object search into the map (processing of clicks) and search (generating parallel results of found map objects).
Specifying categories on the startup page allows a user to understand how the service works and what kind of information it provides.
In most cases the most effective solution will be the manual selection of several categories that are relevant to the subject of your project. For example, for a website about children you may choose educational institutions, baby stores, and maternity hospitals. And for a mobile app for motorists — gas stations, maintenance stations, and tire fitting shops sorted by distance.
Instead of categories you can also use search queries popular among the users of your projects. The most popular categories for a typical urban site: Gas station, Pharmacies, ATMs, Bars, Hotels, Transportation, Cafes, Beauty salons, Service stations, Supermarkets, Taxi, Travel Agencies.
The use of a complete list of categories is justified in a limited number of cases.
If you add your own information to the information obtained from the API, display it on the startup page. If, for example, your users can leave comments on the pages of companies, post the most recent or the most popular ones on the main page.
The list of company branches are generated as a result of the search and when users click on categories.
The page of the company branch can easily be completed with your own content. A few examples.
If you use only the information from API or add an insignificant amount of information, we recommend you to open the company branch info dynamically, right in the search results, performing an AJAX request. This greatly facilitates the navigation due to the fact that a user does not have to make extra clicks to view several found results.
Do not forget to add the map, and specify in the opening hours section whether the company is open at the moment and when it is going to close.
Take advantage of the linked information. Thus, you should display the categories of the company and the number of its branches as links.
Advertising materials in the API are found in the lists of company branches and their profiles. It is important to note that all of them are in the text format and they expand information about the company branch, thereby bringing additional benefits to visitors.
The more advantages of the data section in 2GIS you implement and show your visitors, the more the effectiveness for the entire project will be.