Algolia Places REST API：扩大搜索半径并保留默认fallback机制

Hey there! Great question—this is a common gotcha with Algolia Places when balancing local prioritization and the default fallback behavior. Let's break down what's happening and how to fix it:

Why aroundRadius breaks the fallback #

When you explicitly set the aroundRadius parameter, it acts as a hard filter: Algolia will only return results strictly within that radius, completely overriding the default fallback logic (nearby <10km + national + global popular places). This is why you're only seeing a small set of local results instead of getting broader matches when local ones are scarce.

The fix: Use aroundPrecision instead #

The aroundPrecision parameter is designed exactly for your use case. Instead of limiting results to a strict radius, it tells Algolia to prioritize results within your specified distance, but still fall back to national and global popular places when there aren't enough local matches.

For example, if you want to expand the "prioritized local area" to 20km (instead of the default 10km), set aroundPrecision to 20000 (units are meters):

// Example implementation for web
places({
  container: document.querySelector('#address-input'),
  aroundLatLng: 'YOUR_USER_LATITUDE,YOUR_USER_LONGITUDE',
  aroundPrecision: 20000 // Prioritize 20km radius, keep fallback
});

Bonus: Extra control if needed #

If you want even more granularity, you can combine aroundPrecision with:

• hitsPerPage: Adjust how many results are returned (e.g., hitsPerPage: 10 to show more options)
• countries: Restrict fallback results to specific countries if you don't want global matches (e.g., countries: ['us'] for US-only fallback)

This approach keeps the default fallback behavior intact while letting you expand the area where local results are prioritized.

内容的提问来源于stack exchange，提问作者Adrien Dos Reis