Автозаполнение мест

Служба автозаполнения в Places SDK для Android возвращает подсказки мест в ответ на поисковые запросы пользователей. По мере ввода пользователем служба автозаполнения предлагает предложения для таких мест, как компании, адреса, а также коды и достопримечательности.

Вы можете добавить автозаполнение в свое приложение следующими способами:

• Добавьте виджет автозаполнения , чтобы сэкономить время разработки и обеспечить единообразие взаимодействия с пользователем.
• Получайте прогнозы мест программно, чтобы создать индивидуальный пользовательский интерфейс.

Добавьте виджет автозаполнения

Виджет автозаполнения представляет собой диалоговое окно поиска со встроенной функцией автозаполнения. Когда пользователь вводит условия поиска, виджет представляет список предполагаемых мест на выбор. Когда пользователь делает выбор, возвращается экземпляр Place , который ваше приложение затем может использовать для получения сведений о выбранном месте.

Есть два варианта добавления виджета автозаполнения в ваше приложение:

• Вариант 1. Внедрите AutocompleteSupportFragment .
• Вариант 2. Используйте намерение для запуска действия автозаполнения .

Вариант 1. Внедрение AutocompleteSupportFragment

Чтобы добавить AutocompleteSupportFragment в свое приложение, выполните следующие действия:

1. Добавьте фрагмент в XML-макет вашей деятельности.
2. Добавьте прослушиватель к своей активности или фрагменту.

Добавьте AutocompleteSupportFragment в действие.

Чтобы добавить AutocompleteSupportFragment в действие, добавьте новый фрагмент в макет XML. Например:

<fragment android:id="@+id/autocomplete_fragment"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:name="com.google.android.libraries.places.widget.AutocompleteSupportFragment"
  />

• По умолчанию фрагмент не имеет рамки и фона. Чтобы обеспечить единообразный внешний вид, вложите фрагмент в другой элемент макета, например CardView .
• Если вы используете фрагмент автозаполнения и вам необходимо переопределить onActivityResult , вы должны вызвать super.onActivityResult , иначе фрагмент не будет работать должным образом.

Добавьте PlaceSelectionListener в действие

PlaceSelectionListener обрабатывает возврат места в ответ на выбор пользователя. Следующий код показывает создание ссылки на фрагмент и добавление прослушивателя к вашему AutocompleteSupportFragment :

    // Initialize the AutocompleteSupportFragment.
    val autocompleteFragment =
        supportFragmentManager.findFragmentById(R.id.autocomplete_fragment)
                as AutocompleteSupportFragment

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(listOf(Place.Field.ID, Place.Field.NAME))

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(object : PlaceSelectionListener {
        override fun onPlaceSelected(place: Place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: ${place.name}, ${place.id}")
        }

        override fun onError(status: Status) {
            // TODO: Handle the error.
            Log.i(TAG, "An error occurred: $status")
        }
    })

      

    // Initialize the AutocompleteSupportFragment.
    AutocompleteSupportFragment autocompleteFragment = (AutocompleteSupportFragment)
            getSupportFragmentManager().findFragmentById(R.id.autocomplete_fragment);

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(Arrays.asList(Place.Field.ID, Place.Field.NAME));

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(new PlaceSelectionListener() {
        @Override
        public void onPlaceSelected(@NonNull Place place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
        }


        @Override
        public void onError(@NonNull Status status) {
            // TODO: Handle the error.
            Log.i(TAG, "An error occurred: " + status);
        }
    });

      

Вариант 2. Используйте намерение для запуска действия автозаполнения.

Если вы хотите, чтобы ваше приложение использовало другой процесс навигации (например, чтобы запускало автозаполнение с помощью значка, а не поля поиска), ваше приложение может запустить автозаполнение, используя намерение.

Чтобы запустить виджет автозаполнения с использованием намерения, выполните следующие действия:

1. Используйте Autocomplete.IntentBuilder , чтобы создать намерение, передав желаемый режим Autocomplete .
2. Определите средство запуска результатов активности registerForActivityResult , которое можно использовать для запуска намерения и обработки прогноза выбранного пользователем места в результате.

Создайте намерение автозаполнения

В приведенном ниже примере Autocomplete.IntentBuilder используется для создания намерения запустить виджет автозаполнения в качестве намерения:

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    val fields = listOf(Place.Field.ID, Place.Field.NAME)

    // Start the autocomplete intent.
    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .build(this)
    startAutocomplete.launch(intent)

      

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    List<Place.Field> fields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

    // Start the autocomplete intent.
    Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
            .build(this);
    startAutocomplete.launch(intent);

      

При использовании намерения запустить виджет автозаполнения вы можете выбрать режим наложения или полноэкранного отображения. На следующих снимках экрана показаны каждый режим отображения соответственно:

Зарегистрируйте обратный вызов для результата намерения

Чтобы получать уведомление, когда пользователь выбирает место, определите средство запуска registerForActivityResult() , которое запускает действие, а также обрабатывает результат, как показано в следующем примере. Если пользователь выбрал прогноз, он будет доставлен в намерении, содержащемся в объекте результата. Поскольку намерение было создано с помощью Autocomplete.IntentBuilder , метод Autocomplete.getPlaceFromIntent() может извлечь из него объект Place.

private val startAutocomplete =
    registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result: ActivityResult ->
        if (result.resultCode == Activity.RESULT_OK) {
            val intent = result.data
            if (intent != null) {
                val place = Autocomplete.getPlaceFromIntent(intent)
                Log.i(
                    TAG, "Place: ${place.name}, ${place.id}"
                )
            }
        } else if (result.resultCode == Activity.RESULT_CANCELED) {
            // The user canceled the operation.
            Log.i(TAG, "User canceled autocomplete")
        }
    }

      

private final ActivityResultLauncher<Intent> startAutocomplete = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            if (result.getResultCode() == Activity.RESULT_OK) {
                Intent intent = result.getData();
                if (intent != null) {
                    Place place = Autocomplete.getPlaceFromIntent(intent);
                    Log.i(TAG, "Place: ${place.getName()}, ${place.getId()}");
                }
            } else if (result.getResultCode() == Activity.RESULT_CANCELED) {
                // The user canceled the operation.
                Log.i(TAG, "User canceled autocomplete");
            }
        });

      

Программное получение прогнозов мест

Вы можете создать собственный пользовательский интерфейс поиска в качестве альтернативы пользовательскому интерфейсу, предоставляемому виджетом автозаполнения. Для этого ваше приложение должно программно получать прогнозы мест. Ваше приложение может получить список предсказанных названий мест и/или адресов из API автозаполнения, вызвав PlacesClient.findAutocompletePredictions() и передав объект FindAutocompletePredictionsRequest со следующими параметрами:

• Обязательно: строка query , содержащая текст, введенный пользователем.
• Рекомендуется: AutocompleteSessionToken , который группирует этапы запроса и выбора пользовательского поиска в отдельный сеанс для целей выставления счетов. Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место.
• Рекомендуется: объект RectangularBounds , который определяет границы широты и долготы, чтобы ограничить результаты указанным регионом .
• Необязательно: один или несколько двухбуквенных кодов страны (ISO 3166-1 Alpha-2), указывающих страну или страны, результаты которых должны быть ограничены.

• Необязательно: TypeFilter , который можно использовать, чтобы ограничить результаты указанным типом места. Поддерживаются следующие типы мест:

  • TypeFilter.GEOCODE – возвращает только результаты геокодирования, а не компании. Используйте этот запрос, чтобы устранить неоднозначность результатов, в которых указанное местоположение может быть неопределенным.
  • TypeFilter.ADDRESS — возвращает только результаты автозаполнения с точным адресом. Используйте этот тип, если вы знаете, что пользователь ищет полностью указанный адрес.
  • TypeFilter.ESTABLISHMENT – возвращает только места, являющиеся предприятиями.

  • TypeFilter.REGIONS – возвращает только места, соответствующие одному из следующих типов:

  • LOCALITY

  • SUBLOCALITY

  • POSTAL_CODE

  • COUNTRY

  • ADMINISTRATIVE_AREA_LEVEL_1

  • ADMINISTRATIVE_AREA_LEVEL_2

  • TypeFilter.CITIES – возвращает только результаты, соответствующие LOCALITY или ADMINISTRATIVE_AREA_LEVEL_3 .

• Необязательно: LatLng указывающий местоположение источника запроса. Когда вы вызываете setOrigin() , служба возвращает расстояние в метрах ( distanceMeters ) от указанного источника для каждого прогноза автозаполнения в ответе.

Информацию о типах мест см. в руководстве по типам мест .

В примере ниже показан полный вызов PlacesClient.findAutocompletePredictions() .

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    val token = AutocompleteSessionToken.newInstance()

    // Create a RectangularBounds object.
    val bounds = RectangularBounds.newInstance(
        LatLng(-33.880490, 151.184363),
        LatLng(-33.858754, 151.229596)
    )
    // Use the builder to create a FindAutocompletePredictionsRequest.
    val request =
        FindAutocompletePredictionsRequest.builder()
            // Call either setLocationBias() OR setLocationRestriction().
            .setLocationBias(bounds)
            //.setLocationRestriction(bounds)
            .setOrigin(LatLng(-33.8749937, 151.2041382))
            .setCountries("AU", "NZ")
            .setTypesFilter(listOf(PlaceTypes.ADDRESS))
            .setSessionToken(token)
            .setQuery(query)
            .build()
    placesClient.findAutocompletePredictions(request)
        .addOnSuccessListener { response: FindAutocompletePredictionsResponse ->
            for (prediction in response.autocompletePredictions) {
                Log.i(TAG, prediction.placeId)
                Log.i(TAG, prediction.getPrimaryText(null).toString())
            }
        }.addOnFailureListener { exception: Exception? ->
            if (exception is ApiException) {
                Log.e(TAG, "Place not found: ${exception.statusCode}")
            }
        }

      

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    AutocompleteSessionToken token = AutocompleteSessionToken.newInstance();

    // Create a RectangularBounds object.
    RectangularBounds bounds = RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596));
    // Use the builder to create a FindAutocompletePredictionsRequest.
    FindAutocompletePredictionsRequest request = FindAutocompletePredictionsRequest.builder()
            // Call either setLocationBias() OR setLocationRestriction().
            .setLocationBias(bounds)
            //.setLocationRestriction(bounds)
            .setOrigin(new LatLng(-33.8749937, 151.2041382))
            .setCountries("AU", "NZ")
            .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS))
            .setSessionToken(token)
            .setQuery(query)
            .build();

    placesClient.findAutocompletePredictions(request).addOnSuccessListener((response) -> {
        for (AutocompletePrediction prediction : response.getAutocompletePredictions()) {
            Log.i(TAG, prediction.getPlaceId());
            Log.i(TAG, prediction.getPrimaryText(null).toString());
        }
    }).addOnFailureListener((exception) -> {
        if (exception instanceof ApiException) {
            ApiException apiException = (ApiException) exception;
            Log.e(TAG, "Place not found: " + apiException.getStatusCode());
        }
    });

      

API возвращает FindAutocompletePredictionsResponse в Task . FindAutocompletePredictionsResponse содержит список объектов AutocompletePrediction , представляющих прогнозируемые места. Список может быть пустым, если не известно место, соответствующее запросу и критериям фильтра.

Для каждого предсказанного места вы можете вызвать следующие методы для получения сведений о месте:

• getFullText(CharacterStyle) возвращает полный текст описания места. Это сочетание первичного и вторичного текста. Пример: « Эйфелева башня, авеню Анатоля Франса, Париж, Франция ». Кроме того, этот метод позволяет выделить разделы описания, соответствующие поиску, стилем по вашему выбору, используя CharacterStyle . Параметр CharacterStyle является необязательным. Установите для него значение null, если вам не нужна подсветка.
• getPrimaryText(CharacterStyle) возвращает основной текст, описывающий место. Обычно это название места. Примеры: « Эйфелева башня » и « Питт-стрит, 123 ».
• getSecondaryText(CharacterStyle) возвращает вспомогательный текст описания места. Это полезно, например, в качестве второй строки при отображении подсказок автозаполнения. Примеры: « Авеню Анатоль Франс, Париж, Франция » и « Сидней, Новый Южный Уэльс ».
• getPlaceId() возвращает идентификатор предсказанного места. Идентификатор места — это текстовый идентификатор, однозначно идентифицирующий место, который можно использовать для повторного получения объекта Place позже. Дополнительную информацию об идентификаторах мест в Places SDK для Android см. в разделе «Сведения о месте» . Общую информацию об идентификаторах мест см. в обзоре идентификаторов мест .
• getPlaceTypes() возвращает список типов мест, связанных с этим местом.
• getDistanceMeters() возвращает расстояние по прямой в метрах между этим местом и началом координат, указанным в запросе.

Токены сеанса

Токены сеанса группируют этапы запроса и выбора пользовательского поиска с автозаполнением в отдельный сеанс для целей выставления счетов. Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место. В каждом сеансе может быть несколько запросов, за которыми следует выбор одного места. После завершения сеанса токен больше не действителен; ваше приложение должно генерировать новый токен для каждого сеанса. Мы рекомендуем использовать токены сеанса для всех сеансов программного автозаполнения (когда вы встраиваете фрагмент или запускаете автозаполнение с использованием намерения, API позаботится об этом автоматически).

Places SDK для Android использует AutocompleteSessionToken для идентификации каждого сеанса. Ваше приложение должно передавать новый токен сеанса при начале каждого нового сеанса, а затем передавать этот же токен вместе с идентификатором места при последующем вызове fetchPlace() для получения сведений о месте для места, выбранного пользователем.

Узнайте больше о токенах сеанса .

Ограничить результаты автозаполнения

Вы можете ограничить результаты автозаполнения определенным географическим регионом и/или отфильтровать результаты по одному или нескольким типам мест или до пяти стран. Вы можете применить эти ограничения к действию автозаполнения, AutocompleteSupportFragment и API программного автозаполнения.

Чтобы ограничить результаты, выполните следующие действия:

• Чтобы отдать предпочтение результатам внутри определенного региона, вызовите setLocationBias() (некоторые результаты за пределами определенного региона все равно могут быть возвращены).
• Чтобы отображать результаты только в пределах определенного региона, вызовите setLocationRestriction() (будут возвращены только результаты в пределах определенного региона).
• Чтобы вернуть только результаты, соответствующие определенному типу места, вызовите setTypesFilter() (например, если указать TypeFilter.ADDRESS , будут возвращены только результаты с точным адресом).
• Чтобы вернуть результаты только в пределах пяти указанных стран, вызовите setCountries() . Страны необходимо указывать в виде двухзначного кода страны , совместимого со стандартом ISO 3166-1 Alpha-2.

Смещение результатов в конкретный регион

Чтобы сместить результаты автозаполнения к определенному географическому региону, вызовите setLocationBias() , передав RectangularBounds . В следующем примере кода показан вызов setLocationBias() для экземпляра фрагмента, чтобы сместить предложения автозаполнения к региону Сидней, Австралия.

    autocompleteFragment.setLocationBias(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

    autocompleteFragment.setLocationBias(RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596)));

      

Ограничить результаты определенным регионом

Чтобы ограничить результаты автозаполнения определенным географическим регионом, вызовите setLocationRestriction() , передав RectangularBounds . В следующем примере кода показан вызов setLocationRestriction() для экземпляра фрагмента, чтобы сместить предложения автозаполнения к региону Сидней, Австралия.

    autocompleteFragment.setLocationRestriction(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

    autocompleteFragment.setLocationRestriction(RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596)));

      

Примечание. Это ограничение применяется только ко всем маршрутам. Синтетические результаты, расположенные за пределами прямоугольных границ, могут быть возвращены на основе маршрута, который перекрывается с ограничением местоположения.

Фильтрация результатов по типам мест или коллекции типов

Вы можете ограничить результаты запроса автозаполнения, чтобы они возвращали только определенный тип места. Укажите фильтр, используя типы мест или коллекцию типов, перечисленную в таблицах 1, 2 и 3 в разделе «Типы мест» . Если ничего не указано, возвращаются все типы.

Чтобы отфильтровать результаты автозаполнения, вызовите setTypesFilter() , чтобы установить фильтр.

Чтобы указать тип или фильтр коллекции типов:

• Вызовите setTypesFilter() и укажите до пяти значений типов из Таблицы 1 и Таблицы 2, показанных в Типах мест . Значения типа определяются константами в PlaceTypes .

• Вызовите setTypesFilter() и укажите коллекцию типов из таблицы 3, показанной в разделе Place Types . Значения коллекции определяются константами в PlaceTypes .

  В запросе допускается только один тип из Таблицы 3. Если вы укажете значение из таблицы 3, вы не сможете указать значение из таблицы 1 или таблицы 2. Если вы это сделаете, то произойдет ошибка.

В следующем примере кода вызывается setTypesFilter() для AutocompleteSupportFragment и указывается несколько значений типа.

    autocompleteFragment.setTypesFilter(listOf("landmark", "restaurant", "store"))

      

    autocompleteFragment.setTypesFilter(Arrays.asList("landmark", "restaurant", "store"));

      

В следующем примере кода показан вызов setTypesFilter() для AutocompleteSupportFragment для установки фильтра, возвращающего только результаты с точным адресом, путем указания коллекции типов.

    autocompleteFragment.setTypesFilter(listOf(PlaceTypes.ADDRESS))

      

    autocompleteFragment.setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS, PlaceTypes.ESTABLISHMENT));

      

В следующем примере кода показан вызов setTypesFilter() в IntentBuilder для установки фильтра, возвращающего только результаты с точным адресом, путем указания коллекции типов.

    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .setTypesFilter(listOf(PlaceTypes.ADDRESS))
        .build(this)

      

    Intent intent = new Autocomplete.IntentBuilder(
            AutocompleteActivityMode.FULLSCREEN, fields)
            .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS))
            .build(this);

      

Фильтровать результаты по стране

Чтобы отфильтровать результаты автозаполнения по пяти странам, вызовите setCountries() чтобы установить код страны . Затем передайте фильтр фрагменту или намерению. Страны необходимо указывать в виде двухзначного кода страны , совместимого со стандартом ISO 3166-1 Alpha-2.

В следующем примере кода показан вызов setCountries() для AutocompleteSupportFragment , чтобы установить фильтр, возвращающий результаты только в указанных странах.

    autocompleteFragment.setCountries("AU", "NZ")

      

    autocompleteFragment.setCountries("AU", "NZ");

      

Ограничения использования

Использование API Places, включая Places SDK для Android, больше не ограничивается максимальным количеством запросов в день (QPD). Однако по-прежнему применяются следующие ограничения на использование:

• Ограничение скорости — 6000 QPM (запросов в минуту). Он рассчитывается как сумма запросов на стороне клиента и на стороне сервера для всех приложений, использующих учетные данные одного и того же проекта.

Отображение авторства в вашем приложении

• Если ваше приложение использует службу автозаполнения программно, ваш пользовательский интерфейс должен либо отображать атрибут «Powered by Google», либо отображаться на карте под брендом Google.
• Если ваше приложение использует виджет автозаполнения, никаких дополнительных действий не требуется (нужная атрибуция отображается по умолчанию).
• Если вы получаете и отображаете дополнительную информацию о месте после получения места по идентификатору , вам также необходимо отображать сторонние атрибуции.

Более подробную информацию смотрите в документации по атрибуции .

Оптимизация автозаполнения мест

В этом разделе описаны рекомендации, которые помогут вам максимально эффективно использовать службу автозаполнения мест.

Вот некоторые общие рекомендации:

• Самый быстрый способ разработать работающий пользовательский интерфейс — использовать виджет автозаполнения API JavaScript Карт, виджет автозаполнения Places SDK для Android или элемент управления пользовательского интерфейса Places SDK для автозаполнения iOS.
• С самого начала выработайте понимание основных полей данных автозаполнения места.
• Поля смещения местоположения и ограничения местоположения не являются обязательными, но могут оказать существенное влияние на производительность автозаполнения.
• Используйте обработку ошибок, чтобы обеспечить корректное ухудшение качества вашего приложения, если API возвращает ошибку.
• Убедитесь, что ваше приложение обрабатывает ситуации, когда выбор отсутствует, и предлагает пользователям возможность продолжить.

Лучшие практики оптимизации затрат

Базовая оптимизация затрат

Чтобы оптимизировать затраты на использование службы автозаполнения мест, используйте маски полей в виджетах «Сведения о месте» и «Автозаполнение места», чтобы возвращать только те поля данных о местах, которые вам нужны.

Расширенная оптимизация затрат

Рассмотрите возможность программной реализации автозаполнения мест, чтобы получить доступ к ценам за запрос и запросить результаты API геокодирования о выбранном месте вместо сведений о месте. Цена за запрос в сочетании с API геокодирования является более рентабельной, чем цена за сеанс (на основе сеанса), если выполняются оба следующих условия:

• Если вам нужна только широта/долгота или адрес выбранного пользователем места, API геокодирования предоставляет эту информацию менее чем за вызов Place Details.
• Если пользователи выбирают прогноз автозаполнения в среднем из четырех или менее запросов на прогнозы автозаполнения, цена за запрос может быть более рентабельной, чем цена за сеанс.

Требуется ли вашему приложению какая-либо информация, кроме адреса и широты/долготы выбранного прогноза?

Рекомендации по повышению производительности

В следующих рекомендациях описаны способы оптимизации производительности автозаполнения мест:

• Добавьте ограничения по странам, смещение местоположения и (для программных реализаций) языковые предпочтения в реализацию автозаполнения мест. Языковые настройки не требуются для виджетов, поскольку они выбирают языковые настройки из браузера или мобильного устройства пользователя.
• Если автозаполнение места сопровождается картой, вы можете смещать местоположение в зависимости от области просмотра карты.
• В ситуациях, когда пользователь не выбирает один из прогнозов автозаполнения (обычно потому, что ни один из этих прогнозов не является желаемым адресом результата), вы можете повторно использовать исходный пользовательский ввод, чтобы попытаться получить более релевантные результаты:
  • Если вы ожидаете, что пользователь введет только информацию об адресе, повторно используйте исходный пользовательский ввод при вызове API геокодирования .
  • Если вы ожидаете, что пользователь будет вводить запросы для определенного места по имени или адресу, используйте запрос Find Place . Если результаты ожидаются только в определенном регионе, используйте смещение местоположения .
  Другие сценарии, когда лучше всего вернуться к API геокодирования, включают:
  • Пользователи, вводящие адреса помещений, например адреса конкретных квартир или квартир в здании. Например, чешский адрес «Stroupežnického 3191/17, Praha» дает частичный прогноз при автозаполнении места.
  • Пользователи вводят адреса с префиксами сегментов дорог, например «23-30 29th St, Queens» в Нью-Йорке или «47-380 Kamehameha Hwy, Kaneohe» на острове Кауаи на Гавайях.

Поиск неисправностей

Хотя могут возникать самые разные ошибки, большинство ошибок, которые могут возникнуть в вашем приложении, обычно вызваны ошибками конфигурации (например, был использован неправильный ключ API или ключ API был настроен неправильно) или ошибками квоты (ваше приложение превысило свою квоту). Дополнительную информацию о квотах см. в разделе «Ограничения использования» .

Ошибки, возникающие при использовании элементов управления автозаполнением, возвращаются в обратном вызове onActivityResult() . Вызовите Autocomplete.getStatus() , чтобы получить сообщение о состоянии результата.

Служба автозаполнения в Places SDK для Android возвращает подсказки мест в ответ на поисковые запросы пользователей. По мере ввода пользователем служба автозаполнения предлагает предложения для таких мест, как компании, адреса, а также коды и достопримечательности.

Вы можете добавить автозаполнение в свое приложение следующими способами:

• Добавьте виджет автозаполнения , чтобы сэкономить время разработки и обеспечить единообразие взаимодействия с пользователем.
• Получайте прогнозы мест программно, чтобы создать индивидуальный пользовательский интерфейс.

Добавьте виджет автозаполнения

Виджет автозаполнения представляет собой диалоговое окно поиска со встроенной функцией автозаполнения. Когда пользователь вводит условия поиска, виджет представляет список предполагаемых мест на выбор. Когда пользователь делает выбор, возвращается экземпляр Place , который ваше приложение затем может использовать для получения сведений о выбранном месте.

Есть два варианта добавления виджета автозаполнения в ваше приложение:

• Вариант 1: внедрить AutocompleteSupportFragment .
• Вариант 2. Используйте намерение для запуска действия автозаполнения .

Вариант 1. Внедрение AutocompleteSupportFragment

Чтобы добавить AutocompleteSupportFragment в свое приложение, выполните следующие действия:

1. Добавьте фрагмент в XML-макет вашей деятельности.
2. Добавьте прослушиватель к своей активности или фрагменту.

Добавьте AutocompleteSupportFragment в действие.

Чтобы добавить AutocompleteSupportFragment в действие, добавьте новый фрагмент в макет XML. Например:

<fragment android:id="@+id/autocomplete_fragment"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:name="com.google.android.libraries.places.widget.AutocompleteSupportFragment"
  />

• По умолчанию фрагмент не имеет рамки и фона. Чтобы обеспечить единообразный внешний вид, вложите фрагмент в другой элемент макета, например CardView .
• Если вы используете фрагмент автозаполнения и вам необходимо переопределить onActivityResult , вы должны вызвать super.onActivityResult , иначе фрагмент не будет работать должным образом.

Добавьте PlaceSelectionListener в действие

PlaceSelectionListener обрабатывает возврат места в ответ на выбор пользователя. Следующий код показывает создание ссылки на фрагмент и добавление прослушивателя к вашему AutocompleteSupportFragment :

    // Initialize the AutocompleteSupportFragment.
    val autocompleteFragment =
        supportFragmentManager.findFragmentById(R.id.autocomplete_fragment)
                as AutocompleteSupportFragment

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(listOf(Place.Field.ID, Place.Field.NAME))

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(object : PlaceSelectionListener {
        override fun onPlaceSelected(place: Place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: ${place.name}, ${place.id}")
        }

        override fun onError(status: Status) {
            // TODO: Handle the error.
            Log.i(TAG, "An error occurred: $status")
        }
    })

      

    // Initialize the AutocompleteSupportFragment.
    AutocompleteSupportFragment autocompleteFragment = (AutocompleteSupportFragment)
            getSupportFragmentManager().findFragmentById(R.id.autocomplete_fragment);

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(Arrays.asList(Place.Field.ID, Place.Field.NAME));

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(new PlaceSelectionListener() {
        @Override
        public void onPlaceSelected(@NonNull Place place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
        }


        @Override
        public void onError(@NonNull Status status) {
            // TODO: Handle the error.
            Log.i(TAG, "An error occurred: " + status);
        }
    });

      

Вариант 2. Используйте намерение для запуска действия автозаполнения.

Если вы хотите, чтобы ваше приложение использовало другой процесс навигации (например, чтобы запускало автозаполнение с помощью значка, а не поля поиска), ваше приложение может запустить автозаполнение, используя намерение.

Чтобы запустить виджет автозаполнения с использованием намерения, выполните следующие действия:

1. Используйте Autocomplete.IntentBuilder , чтобы создать намерение, передав желаемый режим Autocomplete .
2. Определите средство запуска результатов активности registerForActivityResult , которое можно использовать для запуска намерения и обработки выбранного пользователем прогноза места в результате.

Создайте намерение автозаполнения

В приведенном ниже примере Autocomplete.IntentBuilder используется для создания намерения запустить виджет автозаполнения в качестве намерения:

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    val fields = listOf(Place.Field.ID, Place.Field.NAME)

    // Start the autocomplete intent.
    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .build(this)
    startAutocomplete.launch(intent)

      

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    List<Place.Field> fields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

    // Start the autocomplete intent.
    Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
            .build(this);
    startAutocomplete.launch(intent);

      

При использовании намерения запустить виджет автозаполнения вы можете выбрать режим наложения или полноэкранного отображения. На следующих снимках экрана показаны каждый режим отображения соответственно:

Зарегистрируйте обратный вызов для результата намерения

Чтобы получать уведомление, когда пользователь выбирает место, определите средство запуска registerForActivityResult() , которое запускает действие, а также обрабатывает результат, как показано в следующем примере. Если пользователь выбрал прогноз, он будет доставлен в намерении, содержащемся в объекте результата. Поскольку намерение было создано с помощью Autocomplete.IntentBuilder , метод Autocomplete.getPlaceFromIntent() может извлечь из него объект Place.

private val startAutocomplete =
    registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result: ActivityResult ->
        if (result.resultCode == Activity.RESULT_OK) {
            val intent = result.data
            if (intent != null) {
                val place = Autocomplete.getPlaceFromIntent(intent)
                Log.i(
                    TAG, "Place: ${place.name}, ${place.id}"
                )
            }
        } else if (result.resultCode == Activity.RESULT_CANCELED) {
            // The user canceled the operation.
            Log.i(TAG, "User canceled autocomplete")
        }
    }

      

private final ActivityResultLauncher<Intent> startAutocomplete = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            if (result.getResultCode() == Activity.RESULT_OK) {
                Intent intent = result.getData();
                if (intent != null) {
                    Place place = Autocomplete.getPlaceFromIntent(intent);
                    Log.i(TAG, "Place: ${place.getName()}, ${place.getId()}");
                }
            } else if (result.getResultCode() == Activity.RESULT_CANCELED) {
                // The user canceled the operation.
                Log.i(TAG, "User canceled autocomplete");
            }
        });

      

Программное получение прогнозов мест

Вы можете создать собственный пользовательский интерфейс поиска в качестве альтернативы пользовательскому интерфейсу, предоставляемому виджетом автозаполнения. Для этого ваше приложение должно программно получать прогнозы мест. Ваше приложение может получить список предсказанных названий мест и/или адресов из API автозаполнения, вызвав PlacesClient.findAutocompletePredictions() и передав объект FindAutocompletePredictionsRequest со следующими параметрами:

• Обязательно: строка query , содержащая текст, введенный пользователем.
• Рекомендуется: AutocompleteSessionToken , который группирует этапы запроса и выбора пользовательского поиска в отдельный сеанс для целей выставления счетов. Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место.
• Рекомендуется: объект RectangularBounds , который определяет границы широты и долготы, чтобы ограничить результаты указанным регионом .
• Необязательно: один или несколько двухбуквенных кодов страны (ISO 3166-1 Alpha-2), указывающих страну или страны, результаты которых должны быть ограничены.

• Необязательно: TypeFilter , который можно использовать, чтобы ограничить результаты указанным типом места. Поддерживаются следующие типы мест:

  • TypeFilter.GEOCODE – возвращает только результаты геокодирования, а не компании. Используйте этот запрос, чтобы устранить неоднозначность результатов, в которых указанное местоположение может быть неопределенным.
  • TypeFilter.ADDRESS — возвращает только результаты автозаполнения с точным адресом. Используйте этот тип, если вы знаете, что пользователь ищет полностью указанный адрес.
  • TypeFilter.ESTABLISHMENT – возвращает только места, являющиеся предприятиями.

  • TypeFilter.REGIONS – возвращает только места, соответствующие одному из следующих типов:

  • LOCALITY

  • SUBLOCALITY

  • POSTAL_CODE

  • COUNTRY

  • ADMINISTRATIVE_AREA_LEVEL_1

  • ADMINISTRATIVE_AREA_LEVEL_2

  • TypeFilter.CITIES – возвращает только результаты, соответствующие LOCALITY или ADMINISTRATIVE_AREA_LEVEL_3 .

• Необязательно: LatLng указывающий местоположение источника запроса. Когда вы вызываете setOrigin() , служба возвращает расстояние в метрах ( distanceMeters ) от указанного источника для каждого прогноза автозаполнения в ответе.

Информацию о типах мест см. в руководстве по типам мест .

В примере ниже показан полный вызов PlacesClient.findAutocompletePredictions() .

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    val token = AutocompleteSessionToken.newInstance()

    // Create a RectangularBounds object.
    val bounds = RectangularBounds.newInstance(
        LatLng(-33.880490, 151.184363),
        LatLng(-33.858754, 151.229596)
    )
    // Use the builder to create a FindAutocompletePredictionsRequest.
    val request =
        FindAutocompletePredictionsRequest.builder()
            // Call either setLocationBias() OR setLocationRestriction().
            .setLocationBias(bounds)
            //.setLocationRestriction(bounds)
            .setOrigin(LatLng(-33.8749937, 151.2041382))
            .setCountries("AU", "NZ")
            .setTypesFilter(listOf(PlaceTypes.ADDRESS))
            .setSessionToken(token)
            .setQuery(query)
            .build()
    placesClient.findAutocompletePredictions(request)
        .addOnSuccessListener { response: FindAutocompletePredictionsResponse ->
            for (prediction in response.autocompletePredictions) {
                Log.i(TAG, prediction.placeId)
                Log.i(TAG, prediction.getPrimaryText(null).toString())
            }
        }.addOnFailureListener { exception: Exception? ->
            if (exception is ApiException) {
                Log.e(TAG, "Place not found: ${exception.statusCode}")
            }
        }

      

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    AutocompleteSessionToken token = AutocompleteSessionToken.newInstance();

    // Create a RectangularBounds object.
    RectangularBounds bounds = RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596));
    // Use the builder to create a FindAutocompletePredictionsRequest.
    FindAutocompletePredictionsRequest request = FindAutocompletePredictionsRequest.builder()
            // Call either setLocationBias() OR setLocationRestriction().
            .setLocationBias(bounds)
            //.setLocationRestriction(bounds)
            .setOrigin(new LatLng(-33.8749937, 151.2041382))
            .setCountries("AU", "NZ")
            .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS))
            .setSessionToken(token)
            .setQuery(query)
            .build();

    placesClient.findAutocompletePredictions(request).addOnSuccessListener((response) -> {
        for (AutocompletePrediction prediction : response.getAutocompletePredictions()) {
            Log.i(TAG, prediction.getPlaceId());
            Log.i(TAG, prediction.getPrimaryText(null).toString());
        }
    }).addOnFailureListener((exception) -> {
        if (exception instanceof ApiException) {
            ApiException apiException = (ApiException) exception;
            Log.e(TAG, "Place not found: " + apiException.getStatusCode());
        }
    });

      

API возвращает FindAutocompletePredictionsResponse в Task . FindAutocompletePredictionsResponse содержит список объектов AutocompletePrediction , представляющих прогнозируемые места. Список может быть пустым, если не известно место, соответствующее запросу и критериям фильтра.

Для каждого предсказанного места вы можете вызвать следующие методы для получения сведений о месте:

• getFullText(CharacterStyle) возвращает полный текст описания места. Это сочетание первичного и вторичного текста. Пример: « Эйфелева башня, авеню Анатоля Франса, Париж, Франция ». Кроме того, этот метод позволяет выделить разделы описания, соответствующие поиску, стилем по вашему выбору, используя CharacterStyle . Параметр CharacterStyle является необязательным. Установите для него значение null, если вам не нужна подсветка.
• getPrimaryText(CharacterStyle) возвращает основной текст, описывающий место. Обычно это название места. Примеры: « Эйфелева башня » и « Питт-стрит, 123 ».
• getSecondaryText(CharacterStyle) возвращает вспомогательный текст описания места. Это полезно, например, в качестве второй строки при отображении подсказок автозаполнения. Примеры: « Авеню Анатоль Франс, Париж, Франция » и « Сидней, Новый Южный Уэльс ».
• getPlaceId() возвращает идентификатор предсказанного места. Идентификатор места — это текстовый идентификатор, который уникально идентифицирует место, который вы можете использовать для повторного получения объекта Place позже. Дополнительную информацию об идентификаторах мест в Places SDK для Android см. в разделе «Сведения о месте» . Общую информацию об идентификаторах мест см. в обзоре идентификаторов мест .
• getPlaceTypes() возвращает список типов мест, связанных с этим местом.
• getDistanceMeters() возвращает расстояние по прямой в метрах между этим местом и началом координат, указанным в запросе.

Токены сеанса

Токены сеанса группируют этапы запроса и выбора пользовательского поиска с автозаполнением в отдельный сеанс для целей выставления счетов. Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место. Каждый сеанс может иметь несколько запросов, за которым следует один выбор места. Как только сессия завершится, токен больше не является действительным; Ваше приложение должно генерировать свежий токен для каждого сеанса. Мы рекомендуем использовать токены сеансов для всех программных сеансов автозаполнения (когда вы внедряете фрагмент или запускаете автозаполнение с помощью намерения, API об этом автоматически заботится).

В местах SDK для Android используется AutocompleteSessionToken для идентификации каждого сеанса. Ваше приложение должно пройти новый токен сеанса после начала каждого нового сеанса, а затем передать тот же самый токен, а также идентификатор места, в последующем вызове fetchPlace() , чтобы получить детали места для места, которое было выбрано пользователем.

Узнайте больше о токенах сессии .

Ограничить результаты автозаполнения

Вы можете ограничить результаты автозаполнения определенным географическим регионом и/или отфильтровать результаты в один или несколько типов мест или до пяти стран. Вы можете применить эти ограничения к активности автозаполнения, AutocompleteSupportFragment и программным API автозаполнения.

Чтобы ограничить результаты, сделайте следующее:

• Чтобы предпочесть результаты в определенной области, вызов setLocationBias() (некоторые результаты извне определенной области могут быть все еще возвращены).
• Чтобы показать только результаты в определенной области, setLocationRestriction() будут возвращены только результаты в определенной области).
• Чтобы вернуть только результаты, которые соответствуют конкретному типу места, вызовы setTypesFilter() (например, указание TypeFilter.ADDRESS вернет только результаты с точным адресом).
• Чтобы вернуть только результаты в течение пяти указанных стран, вызовите setCountries() . Страны должны быть приняты как двуххамерный, ISO 3166-1 Alpha-2, совместимый с кодом страны .

Смещение приводит к конкретному региону

Чтобы сметить результаты автозаполнения в определенную географическую область, вызовите setLocationBias() , передавая RectangularBounds . В следующем примере кода показывается Calls setLocationBias() на экземпляре фрагмента, чтобы сметить свои предложения по автозаполнению в регион Сиднея, Австралия.

    autocompleteFragment.setLocationBias(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

    autocompleteFragment.setLocationBias(RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596)));

      

Ограничить результаты конкретным регионом

Чтобы ограничить результаты автозаполнения определенной географической областью, вызовите setLocationRestriction() , передавая RectangularBounds . В следующем примере кода показывается Calls setLocationRestriction() на экземпляре фрагмента, чтобы сметить его предложения по автозаполнению в регион Сиднея, Австралия.

    autocompleteFragment.setLocationRestriction(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

    autocompleteFragment.setLocationRestriction(RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596)));

      

Примечание. Это ограничение применяется только к целым маршрутам, синтетические результаты, расположенные за пределами прямоугольных границ, могут быть возвращены на основе маршрута, который перекрывается с ограниченным местоположением.

Результаты фильтров по типам мест или сбора типов

Вы можете ограничить результаты из запроса на автозаполнение, чтобы они возвращали только определенный тип места. Укажите фильтр с использованием типов мест или сбора типов, указанных в таблицах 1, 2 и 3 на типах места . Если ничего не указано, все типы возвращаются.

Чтобы отфильтровать результаты автозаполнения, вызовите setTypesFilter() , чтобы установить фильтр.

Чтобы указать фильтр типа или типа сбора:

• Вызовы setTypesFilter() и укажите до пяти значений типа из таблицы 1 и таблицы 2, показанных на типах места . Значения типа определяются константами в PlateTypes .

• Вызовы setTypesFilter() и укажите сбор типа из таблицы 3, показанного на типах места . Значения сбора определяются константами в PlateTypes .

  Только один тип из таблицы 3 разрешен в запросе. Если вы указали значение из таблицы 3, вы не можете указать значение из таблицы 1 или в таблице 2. Если вы это сделаете, то возникает ошибка.

Следующий пример кода вызывает setTypesFilter() на AutocompleteSupportFragment , а также определяет значения нескольких типов.

    autocompleteFragment.setTypesFilter(listOf("landmark", "restaurant", "store"))

      

    autocompleteFragment.setTypesFilter(Arrays.asList("landmark", "restaurant", "store"));

      

В следующем примере кода показывается setTypesFilter() на AutocompleteSupportFragment , чтобы установить фильтр, возвращающий только результаты с точным адресом, указав сбор типов.

    autocompleteFragment.setTypesFilter(listOf(PlaceTypes.ADDRESS))

      

    autocompleteFragment.setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS, PlaceTypes.ESTABLISHMENT));

      

В следующем примере кода показывается setTypesFilter() на IntentBuilder , чтобы установить фильтр, возвращающий только результаты с точным адресом, указав коллекцию типов.

    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .setTypesFilter(listOf(PlaceTypes.ADDRESS))
        .build(this)

      

    Intent intent = new Autocomplete.IntentBuilder(
            AutocompleteActivityMode.FULLSCREEN, fields)
            .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS))
            .build(this);

      

Фильтруя результаты по стране

Чтобы отфильтровать результаты автозаполнения до пяти стран, вызовите setCountries() чтобы установить код страны . Затем передайте фильтр фрагменту или намерению. Страны должны быть приняты как двуххамерный, ISO 3166-1 Alpha-2, совместимый с кодом страны .

В следующем примере кода показывается Calling setCountries() на AutocompleteSupportFragment , чтобы установить только результаты, возвращающий только результаты в указанных странах.

    autocompleteFragment.setCountries("AU", "NZ")

      

    autocompleteFragment.setCountries("AU", "NZ");

      

Пределы использования

Ваше использование API мест, включая места SDK для Android, больше не ограничивается максимальным количеством запросов в день (QPD). Тем не менее, следующие пределы использования все еще применяются:

• Предел ставки составляет 6000 QPM (запросы в минуту). Он рассчитывается как сумма запросов на стороне клиента и на стороне сервера для всех приложений, использующих учетные данные того же проекта.

Отображать атрибуции в вашем приложении

• Если ваше приложение использует программную службу автозаполнения, ваш пользовательский интерфейс должен либо отображать атрибуцию «Powered By Google», либо отображаться в карте Google-Brenge.
• Если ваше приложение использует виджет автозаполнения, не требуется дополнительного действия (требуемая атрибуция отображается по умолчанию).
• Если вы получаете и отображаете дополнительную информацию о месте после получения места по идентификатору , вы также должны отобразить сторонние атрибуты.

Для получения более подробной информации см. Документацию по атрибутам .

Поместите оптимизацию автозаполнения

В этом разделе описывается лучшие практики, которые помогут вам максимально использовать услугу автозаполнения.

Вот несколько общих руководящих принципов:

• Самый быстрый способ разработки работающего пользовательского интерфейса - это использование API API API API, помещая SDK для Android Autocomplete виджет или помещает SDK для управления автоматическим завершенным пользовательским интерфейсом iOS
• Разработайте понимание существенных мест , которые с самого начала с самого начала.
• Поля смещения местоположения и ограничения местоположения являются необязательными, но могут оказать существенное влияние на производительность автозаполнения.
• Используйте обработку ошибок, чтобы убедиться, что ваше приложение изящно ослабляет, если API возвращает ошибку.
• Убедитесь, что ваше приложение обрабатывает, когда нет выбора, и предлагает пользователям возможность продолжить.

Лучшие практики оптимизации затрат

Основная оптимизация затрат

Чтобы оптимизировать стоимость использования службы автозаполнения места, используйте подробные сведения о полевых масках и поместите виджеты с автозаполнением, чтобы вернуть только необходимые поля данных .

Усовершенствованная оптимизация затрат

Рассмотрим программную реализацию автозаполнения места, чтобы получить доступ к ценообразованию по запросу и запрос результатов API геокодирования о выбранном месте вместо деталей места. Ценообразование для запроса в сочетании с API геокодирования более рентабельно, чем ценообразование на сеанс (на основе сеанса), если оба из следующих условий выполнены:

• Если вам нужна только широта/долгота или адрес выбранного пользователя, геокодирование API предоставляет эту информацию для вызова меньшего размера.
• Если пользователи выбирают предсказание автозаполнения в среднем из четырех запросов прогнозов с автозаполнением или меньше, ценообразование для запроса может быть более экономически эффективной, чем за ценообразование за сеанс.

Требует ли ваша приложение какую -либо информацию, кроме адреса и широты/долготы выбранного прогноза?

Лучшие практики производительности

В следующих руководствах описываются способы оптимизации производительности автозаполнения места:

• Добавьте ограничения страны, смещение местоположения и (для программных реализаций) предпочтения языка к вашему месту реализации. Языковые предпочтения не нужны для виджетов, поскольку они выбирают языковые предпочтения из браузера пользователя или мобильного устройства.
• Если автозаполнение места сопровождается картой, вы можете сметить местоположение по просмотру MAP.
• В ситуациях, когда пользователь не выбирает одно из предсказаний с автозаполнением, как правило, потому что ни одно из этих прогнозов не является желаемым примером результата, вы можете повторно использовать исходный пользовательский ввод, чтобы попытаться получить более релевантные результаты:
  • Если вы ожидаете, что пользователь введет только информацию о адресах, повторно используйте исходный ввод пользователя в вызове API геокодирования .
  • Если вы ожидаете, что пользователь введет запросы для определенного места по имени или адресу, используйте запрос Find Place . Если результаты ожидаются только в конкретной области, используйте смещение местоположения .
  Другие сценарии, когда лучше вернуться к геокодированию API, включают:
  • Пользователи вводят адреса подпресс -адресов, такие как адреса для конкретных единиц или квартир в здании. Например, чешский адрес "Stroupežnického 3191/17, Praha" дает частичный прогноз на месте автозаполнения.
  • Пользователи вводят адреса с префиксами сегмента дорожного движения, такими как «23-30 29th St, Queens» в Нью-Йорке или «47-380 Kamehameha Hwy, Kaneohe» на острове Кауаи на Гавайях.

Поиск неисправностей

Хотя может возникнуть широкий спектр ошибок, большинство ошибок, которые, вероятно, испытывает ваше приложение, обычно вызвано ошибками конфигурации (например, использовался неправильный ключ API, или ключ API был настроен неправильно) или ошибки квот (ваше приложение превысило свою квоту). Смотрите ограничения использования для получения дополнительной информации о квотах.

Ошибки, которые возникают при использовании управления автозаполнением, возвращаются в обратном вызове onActivityResult() . Вызовите Autocomplete.getStatus() , чтобы получить сообщение о состоянии для результата.