了解A3L Location
了解A3L Location
提示： 如果您现有的Android应用使用Google Play服务中提供的位置API，那么只需要进行很少的更改，您就可以使用A3L Location SDK将您的应用移植到亚马逊应用商店。
有关A3L SDK的简短介绍，请参阅了解A3L SDK。
A3L Location是一个位置抽象库，让您能够将位置服务添加到应用中。它同时支持Android和Fire OS这两种设备。对具有Google Play服务的设备，A3L Location依赖于Google Location Services，对于不具有Google Play服务的Android设备则依赖于原生Android框架位置API。A3L Location的API结构类似于Google Location Services API的结构，有助于最大限度地减少您学习和实现SDK所需的工作量。
您还可以将A3L Location与广告SDK一起使用，根据位置确定目标用户，从而增强广告相关性和用户参与度。
A3L Location的工作原理
A3L Location提供单个SDK，其行为因使用的设备而异，但能够在不同设备之间保持尽可能相似的用户体验。A3L Location是抽象化的Android框架位置API和Google Location Services API（属于Google Play服务的一部分）。在启用Google Play服务的设备上，A3L Location使用Google Location Services API。在没有Google Play服务的设备上（如Fire OS设备），A3L Location使用原生Android框架位置API。
功能比较
下表介绍了与Google Location Services相比，A3L Location提供的功能。
A3L Location功能比较
| 功能 |
Google Location Services |
A3L Location |
| 当前位置 |
|
|
| 上个未知位置 |
|
|
| 位置更新 |
|
|
| 位置设置 |
|
|
| 地理围栏 |
|
|
| 活动识别 |
|
|
后续步骤
请参阅A3L Location入门。
Last updated: 2023年9月13日
").insertBefore(this);
}
});
});
$(document).ready(function() {
if ($("#jumpoffset").length) {
var scrollhash = document.getElementById('jumpoffset');
scrollhash.scrollIntoView(true);
if (location.hash) {
location.href = location.hash;
} else {
var scrollbody = document.querySelector('.mainColumn');
scrollbody.scrollIntoView(true);
window.scroll(0, -500);
}
}
});
$(document).ready(function() {
if ($("#jump").length) {
var scrollold = document.getElementById('jump');
scrollold.scrollIntoView(true);
window.scroll(0, -100);
if (location.hash) {
location.href = location.hash;
}
}
});
//resize container on local builds
$(document).ready(function() {
if (window.location.href.indexOf("/127.0.0.1:4000/") > -1) {
document.querySelector('.container-fluid').style.position = 'fixed';
}
});
//add underline to headers
$(document).ready(function() {
if ($(".productTitle").is(':contains("Alexa Skills Kit")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Skills Kit")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($(".productTitle").is(':contains("Alexa Presentation Language (APL)")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Skills Kit")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($(".productTitle").is(':contains("Alexa Connect Kit")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Connect Kit")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($(".productTitle").is(':contains("A/B Testing")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Skills Kit")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($(".productTitle").is(':contains("Alexa Smart Properties")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Smart Properties")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($(".productTitle").is(':contains("Alexa Conversations Developer Guide")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Skills Kit")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($(".productTitle").is(':contains("Alexa Design Guide")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Design Guide")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Design Guide")')) {
$(this).css("padding", "0");
}
});
}
if ($(".productTitle").is(':contains("Alexa Gadgets Toolkit")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Gadgets Toolkit")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Gadgets Toolkit")')) {
$(this).css("padding", "0");
}
});
}
if ($(".productTitle").is(':contains("Alexa Voice Service")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Alexa Voice Service")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($("h1").is(':contains("Alexa Reference Content")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Reference")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($("h1").is(':contains("Alexa Videos")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Videos")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($("h1").is(':contains("Alexa Code Samples")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Code Samples")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
if ($("h1").is(':contains("Documentation Home")')) {
$(".dppnItem a").each(function() {
if ($(this).is(':contains("Home")')) {
$(this).css("border-bottom", "1.3px solid #FFFFFF");
}
});
}
});
$(document).ready(function () {
const myScrollspy = $("#myScrollspy");
if (myScrollspy.length) {
const containsList2orList3 = myScrollspy.find(".list2, .list3").length > 0;
if (containsList2orList3) {
myScrollspy.css("display", "block");
$(".fa.fa-info-circle").show();
} else {
myScrollspy.css("display", "none");
$(".fa.fa-info-circle").hide();
}
}
});
/**
* This function moves the 'page-not-translated' section from its original position
* to a new position after the 'atd-categories-header' and ensures it is displayed
* only in the new location. This is achieved by hiding the section initially,
* moving it, and then displaying it again once it is in the correct position.
*/
$(document).ready(function() {
const $pageNotTranslatedMessage = $('#page-not-translated');
const $desktopCategoriesHeader = $('.navigation-header.atd-categories-header');
const $mobileToggleHeader = $('.mobile-toggle');
if ($pageNotTranslatedMessage.length) {
if ($mobileToggleHeader.length) {
$pageNotTranslatedMessage.insertAfter($mobileToggleHeader);
} else if ($desktopCategoriesHeader.length) {
$pageNotTranslatedMessage.insertAfter($desktopCategoriesHeader);
}
$pageNotTranslatedMessage.show();
}
});
// Function to handle smooth scrolling to target elements when links are clicked
$(document).ready(function () {
$('.customspy a, .mainColumn a').on('click', function (event) {
const targetId = $(this).attr('href');
if (targetId && targetId.startsWith('#')) {
event.preventDefault();
const targetElement = document.querySelector(`[id="${targetId.replace('#', '')}"]`);
if (targetElement) {
const hash = targetId.substring(1);
window.history.pushState(null, '', `#${hash}`);
targetElement.scrollIntoView(true);
window.scroll(0, -500);
}
}
});
});
window.addEventListener('DOMContentLoaded', function () {
const targetId = window.location.hash;
if (targetId) {
const targetElement = document.querySelector(targetId);
if (targetElement) {
setTimeout(() => {
targetElement.scrollIntoView(true);
window.scrollBy(0, -500);
}, 10);
}
}
});
function activateContentBasedOnHash() {
const currentHash = window.location.hash.substring(1);
if (currentHash) {
const contentElement = document.getElementById(currentHash);
if (contentElement) {
activateTabAndContent(contentElement);
}
}
}
function activateTabAndContent(contentElement) {
const tabSection = contentElement.closest('.tab-pane');
if (tabSection) {
const parentTabLink = document.querySelector(`a[href='#${tabSection.id}']`);
if (parentTabLink) {
const parentNavTabs = parentTabLink.closest('.nav-tabs');
if (parentNavTabs) {
parentNavTabs.querySelectorAll('.nav-link').forEach(link => {
link.classList.remove('active', 'show');
});
parentTabLink.classList.add('active', 'show');
}
const parentTabContent = tabSection.closest('.tab-content');
if (parentTabContent) {
parentTabContent.querySelectorAll('.tab-pane').forEach(tab => {
tab.classList.remove('active', 'show');
});
tabSection.classList.add('active', 'show');
}
}
}
}
function scrollToHashWithOffset() {
const tabHash = window.location.hash;
const targetTabLink = document.querySelector(`.nav-tabs a[href="${tabHash}"]`);
const mainContentColumn = document.querySelector('.inline');
if (targetTabLink && mainContentColumn) {
const totalHeaderHeight = getTotalHeaderHeight() + 40;
targetTabLink.scrollIntoView({behavior: 'smooth', block: 'start'});
setTimeout(() => {
mainContentColumn.scrollBy(0, -totalHeaderHeight);
}, 20);
}
}
function getTotalHeaderHeight() {
return [...document.querySelectorAll('.atd-services-header, .atd-categories-header')]
.reduce((total, header) => total + (header ? header.offsetHeight : 0), 0);
}
function handleClick(event) {
event.preventDefault();
const link = event.currentTarget;
const hash = link.getAttribute('href').substring(1);
const contentElement = document.getElementById(hash);
if (contentElement) {
activateTabAndContent(contentElement);
scrollToHashWithOffset();
}
}
function handleBackToTopClick(event) {
event.preventDefault();
const mainContentColumn = document.querySelector('.inline');
if (mainContentColumn) {
mainContentColumn.scrollTo({top: 0, behavior: 'smooth'});
}
window.scrollTo({top: 0, behavior: 'smooth'});
}
document.addEventListener('DOMContentLoaded', () => {
activateContentBasedOnHash();
scrollToHashWithOffset();
const myScrollspy = document.getElementById('myScrollspy');
if (myScrollspy) {
myScrollspy.querySelectorAll('a[href^="#"]').forEach(link => {
link.addEventListener('click', handleClick);
});
}
document.querySelectorAll('.dpfBackToTopLink, .backToTop').forEach(link => {
link.addEventListener('click', handleBackToTopClick);
});
});
// Show tab link as selected when clicked
$(document).ready(function() {
$('.nav-tabs > li > a').on('click', function(e) {
e.preventDefault();
$(this).tab('show');
$(this).addClass('active show');
});
});
// Fix for when version dropdown is on the same page as nav tab dropdown
// closes other dropdown menu to avoid overlap/usability issues
$(document).ready(function() {
// Version selector dropdown
$('.versionsButton').click(function(e) {
// Close the nav tab dropdown if open
$('.nav-link.dropdown-toggle').siblings('.dropdown-menu').removeClass('show');
});
// Nav tab selector dropdown
$('.nav-link.dropdown-toggle').click(function(e) {
// Close the version dropdown if open
$('.versionsButton').siblings('.dropdown-menu').removeClass('show');
});
});
// Handle active state management for dropdown menu in nav-tabs
// Fixes edge case issues for when version selector dropdown and
// nav-tab dropdown appear on the same page
$(document).ready(function() {
// Function to deactivate all tab panes and reset dropdown items
function deactivateAllTabs() {
$('.position .nav-item.dropdown .dropdown-menu .dropdown-item').each(function() {
const targetId = $(this).attr('href');
$(targetId).removeClass('active show');
$(this).removeClass('active show');
});
}
// Store the original pushState function
const originalPushState = history.pushState;
// Create a custom event for pushState
const pushStateEvent = new Event('pushState');
// Override pushState
history.pushState = function() {
originalPushState.apply(this, arguments);
// Dispatch the custom event
window.dispatchEvent(pushStateEvent);
};
// Add pushState listener
window.addEventListener('pushState', function() {
const params = new URLSearchParams(window.location.search);
const vValue = params.get('v');
// Handle query parameter change from version selector
if (vValue) {
// Remove active classes from all tabs
deactivateAllTabs();
$('.position').each(function() {
var firstTabPane = $(this).find('.tab-pane').first();
if (firstTabPane.length > 0) {
var tabId = firstTabPane.attr('id');
var dropdownItem = $('.dropdown-menu .dropdown-item[href="#' + tabId + '"]');
// Make first tab in each version active
dropdownItem.addClass('active show');
firstTabPane.addClass('active show');
}
});
}
});
// Handle dropdown item clicks
$('.position .nav-item.dropdown .dropdown-menu .dropdown-item').click(function(e) {
e.preventDefault();
// Remove active classes from all tabs
deactivateAllTabs();
// Add active class to clicked item
$(this).addClass('active show');
// Show corresponding tab content
const targetId = $(this).attr('href');
$(targetId).addClass('active show');
});
// Handle initial load from URL hash
if (window.location.hash) {
const tabId = window.location.hash;
// Only manipulate tabs if the hash matches a dropdown item (i.e., it's a tab ID)
const matchingDropdownItem = $(`.position .nav-item.dropdown .dropdown-menu .dropdown-item[href="${tabId}"]`);
if (matchingDropdownItem.length) {
// Deactivate all tabs first
deactivateAllTabs();
// Activate the correct tab and content
matchingDropdownItem.addClass('active show');
$(tabId).addClass('active show');
}
}
});
// Remove show class from caption elements to preserve table-caption display
// (fixes issue where the show class, which forces the display style to block,
// caused the table caption to appear inside the table, rather than above it)
$(document).ready(function() {
if (window.location.hash) {
const anchorId = window.location.hash.substring(1);
const targetElement = document.getElementById(anchorId);
if (targetElement) {
const captionParent = $(targetElement).closest('caption');
if (captionParent.length) {
captionParent.removeClass('show');
}
}
}
});
